RDF Explorer v1.0.0

RDF Explorer v1.0.0

概述

一个模型上下文协议（MCP）服务，可通过对话界面探索和分析基于 RDF（Turtle）的知识图谱，支持本地文件模式或 SPARQL 端点模式。此服务可促进 AI 应用（主机/客户端）与 RDF 数据之间的通信，从而通过 SPARQL 查询探索图谱并分析图谱数据。是知识图谱研究和 AI 数据准备的理想工具。

组件

工具

该服务提供 SPARQL 查询和搜索功能：

• execute_on_endpoint

  • 直接在外部端点上执行 SPARQL 查询
  • 输入：
    • endpoint (str)：要查询的 SPARQL 端点 URL。
    • query (str)：要执行的 SPARQL 查询。
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：以换行符分隔的查询结果字符串，或错误消息。

• sparql_query

  • 在当前图谱或活动的外部端点上执行 SPARQL 查询
  • 输入：
    • query (str)：要执行的 SPARQL 查询。
    • ctx (Context)：FastMCP 上下文对象。
    • use_service (bool)：在本地模式下，是否使用 SERVICE 子句执行联合查询（默认：True）。
  • 返回：以换行符分隔的查询结果字符串，或错误消息。

• graph_stats

  • 计算图谱统计信息并以 JSON 格式返回
  • 输入：
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：包含图谱统计信息（例如三元组数量、唯一主语数量）的 JSON 字符串。

• count_triples

  • 统计图谱中的三元组数量。在 SPARQL 端点模式下已禁用；请改用自定义提示词。
  • 输入：
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：以字符串形式表示的三元组数量，或错误消息。

• full_text_search

  • 在图谱或端点上执行全文搜索，避免使用专有语法。
  • 输入：
    • search_term (str)：要搜索的词语。
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：以换行符分隔的搜索结果字符串，或错误消息。

• health_check

  • 检查三元组存储连接的运行状况。
  • 输入：
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：连接正常时返回“Healthy”，否则返回“Unhealthy: ”。

• get_mode

  • 获取 RDF Explorer 的当前模式。知识图谱和语义技术用户可借此验证数据源。
  • 输入：
    • ctx (Context)：FastMCP 上下文对象。
  • 返回：指明模式和数据集或端点的消息。

资源

该服务提供以下资源：

• schema://all：从图谱中获取架构信息（类和属性）。

  • 返回：以换行符分隔的架构元素（类和属性）字符串。

• queries://{template_name}：按名称获取预定义的 SPARQL 查询模板。

  • 返回：SPARQL 查询字符串，或“Template not found”。

• explore://{query_name}：按名称执行探索性 SPARQL 查询，并以 JSON 格式返回结果。

  • query_name (str)：探索性查询的名称（例如“classes”“relationships/URI”）。
  • 返回：查询结果的 JSON 字符串。

• explore://report：生成探索性查询的 Markdown 报告。

  • 返回：Markdown 格式的报告字符串。

提示词

该服务提供以下提示词：

• analyze_graph_structure：使用架构数据启动图谱结构分析。

  • 返回：用于指导图谱结构分析的消息列表。

• find_relationships：生成用于查找给定主语相关关系的 SPARQL 查询。

  • 返回：用于查找关系的 SPARQL 查询字符串。

• text_to_sparql：将文本提示词转换为 SPARQL 查询并执行，同时检查令牌数限制。

  • prompt (str)：要转换为 SPARQL 的文本提示词。
  • 返回：包含用量统计的查询结果，或错误消息。

设置

配置

在 Claude Desktop 上安装

开始之前，请确保已安装 Claude Desktop。

1. 前往：设置 > 开发者 > 编辑配置

2. 将以下内容添加到 claude_desktop_config.json： MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

若要使用本地 RDF Turtle 文件，请使用此版本并传入 --triple-file 参数

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

若要使用 SPARQL Endpoint，请使用此版本并传入 --sparql-endpoint 参数

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

3. 重启 Claude Desktop，然后开始查询和探索图数据。

4. 提示词：“RDF Explorer 当前运行在哪种模式下？”

使用示例

以下示例展示了如何使用自然语言探索 RDF 数据：

在本地文件模式下查询数据

你可以提出以下问题：

• “显示销售部门的所有员工”
• “找出年龄最大的 5 位客户”
• “上个月购买了超过 3 种产品的人是谁？”
• “列出所有实体”
• “使用 DBpedia 端点，列出 Michael Jackson 的 10 首歌曲”
• “使用 Wikidata 端点，列出 5 座城市”
• “统计三元组数量”
• “分析图结构”
• “Select ...”
• “search '{text}' ”
• “find relationships of '{URI}'”
• “RDF Explorer 当前运行在哪种模式下？”

在 SPARQL Endpoint 模式下查询数据

你可以提出以下问题：

• “使用 DBpedia 端点，列出 Michael Jackson 的 10 首歌曲”
• “使用 Wikidata 端点，列出 5 座城市”
• “Select ...”
• “search '{text}' ”
• “find relationships of '{URI}'”
• “RDF Explorer 当前运行在哪种模式下？”

开发

# clone the repository
git clone https://github.com/emekaokoye/mcp-rdf-explorer.git
cd mcp-rdf-explorer

# setup a virtual environment
python -m venv venv
source venv/bin/activate
# windows: venv\Scripts\activate

# install development dependencies
pip install -r requirements.txt

# run tests
pytest test_rdf_explorer.py -v

许可证

此 MCP 服务采用 MIT License 许可。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 许可证 文件。