RDF Explorer

🚀 RDF 探索者 v1.0.0

RDF 探索者是一个模型上下文协议（MCP）服务器，它提供了基于对话界面的知识图谱（RDF 格式）探索和分析功能。支持本地文件模式和 SPARQL 终端模式，借助自然语言处理技术，实现了 AI 与知识图谱的交互，让用户能以问答形式便捷地从知识图谱中获取信息或执行复杂数据操作。

🚀 快速开始

# 克隆仓库
git clone https://github.com/emekaokoye/mcp-rdf-explorer.git
cd mcp-rdf-explorer

# 初始化虚拟环境
python -m venv venv
source venv/bin/activate
# Windows: venv\Scripts\activate

# 安装开发依赖
pip install -r requirements.txt

# 运行测试
pytest test_rdf_explorer.py -v

✨ 主要特性

• 本地文件模式：支持加载和解析本地的 Turtle 格式 RDF 文件。
• SPARQL 终端模式：支持连接远程 SPARQL 服务进行数据查询。
• 数据查询：支持通过自然语言或直接查询语法从知识图谱中检索数据。
• 数据分析：提供对知识图谱结构、实体关系的分析功能。
• 上下文管理：维护对话上下文，支持多轮交互。
• 结果格式化：支持将查询结果以多种格式（文本、表格、JSON 等）呈现。

📦 安装指南

# 克隆仓库
git clone https://github.com/emekaokoye/mcp-rdf-explorer.git
cd mcp-rdf-explorer

# 初始化虚拟环境
python -m venv venv
source venv/bin/activate
# Windows: venv\Scripts\activate

# 安装开发依赖
pip install -r requirements.txt

💻 使用示例

基础用法

在本地文件模式或 SPARQL 终端模式下，你可以提出以下问题：

• 在本地文件模式下可以提问：
  • "显示所有销售部门的员工"
  • "找出前五名最年长的客户"
  • "谁购买了超过三件产品"
  • "列出所有实体"
  • "使用 DBpedia 终端，列出迈克尔·杰克逊的 10 首歌曲"
  • "使用 Wikidata 终端，列出 5 座城市"
  • "统计三元组数量"
  • "分析知识图谱结构"
  • "选择 ..."
  • "搜索 '{文本}' "
  • "查找 '{URI}' 的关系"
  • "RDF 探索者运行在什么模式？"
• 在 SPARQL 终端模式下可以提问：
  • "使用 DBpedia 终端，列出迈克尔·杰克逊的 10 首歌曲"
  • "使用 Wikidata 终端，列出 5 座城市"
  • "选择 ..."
  • "搜索 '{文本}' "
  • "查找 '{URI}' 的关系"
  • "RDF 探索者运行在什么模式？"

高级用法

示例配置

使用本地文件模式的配置示例：

{
  "mcpServers": {
    "rdf_explorer": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py", "--triple-file", "your_file.ttl"]
    }
  }
}

使用 SPARQL 终端模式的配置示例：

{
  "mcpServers": {
    "rdf_explorer": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py", "--sparql-endpoint", "https://example.com/sparql"]
    }
  }
}

📚 详细文档

工具

输入输出定义

• 输入：
  • 自然语言问题或 SPARQL 查询语句。
  • 可选参数包括：
    • --triple-file：本地 RDF 文件路径。
    • --sparql-endpoint：远程 SPARQL 终点 URL。
• 输出：
  • 结果以用户友好的格式呈现。
  • 支持 JSON 格式输出，便于程序matic 处理。

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参见项目存储库中的 LICENSE 文件。