MCP GraphDB

GraphDB MCP 服务

一个提供对 Ontotext GraphDB 只读访问的模型上下文协议服务。此服务支持大模型探索 RDF 图，并针对 GraphDB 实例执行 SPARQL 查询。

组件

工具

• sparqlQuery

  • 针对已连接的 GraphDB 存储库执行 SPARQL 查询
  • 输入：
    • query（字符串）：要执行的 SPARQL 查询
    • graph（字符串，可选）：目标图的特定 IRI
    • format（字符串，可选）：响应格式（json、xml、csv）
  • 所有查询均以只读模式执行

• listGraphs

  • 列出存储库中的所有图
  • 无需输入参数

资源

此服务提供存储库数据的多个视图：

• 类列表（graphdb://<host>/repository/<repo>/classes）

  • 列出存储库中找到的所有 RDF 类及其计数

• 谓词（graphdb://<host>/repository/<repo>/predicates）

  • 列出所有谓词（属性）及其使用次数

• 统计信息（graphdb://<host>/repository/<repo>/stats）

  • 提供主语、谓词、宾语和三元组的数量

• 示例数据（graphdb://<host>/repository/<repo>/sample）

  • 显示存储库中的部分三元组示例

• 图内容（graphdb://<host>/repository/<repo>/graph/<graphUri>）

  • 提供特定图中的示例数据及其元数据

配置

你可以通过创建 .env 文件，使用环境变量配置此服务：

GRAPHDB_ENDPOINT=http://localhost:7200
GRAPHDB_REPOSITORY=myRepository
GRAPHDB_USERNAME=username
GRAPHDB_PASSWORD=password

或者，也可以通过命令行参数提供端点和存储库：

node dist/index.js http://localhost:7200 myRepository

命令行参数的优先级高于环境变量。

在 Claude Desktop 中使用

若要在 Claude Desktop 桌面应用中使用此服务，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

{
  "mcpServers": {
    "graphdb": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-graphdb/dist/index.js"
      ],
      "env": {
        "GRAPHDB_ENDPOINT": "http://localhost:7200",
        "GRAPHDB_REPOSITORY": "myRepository",
        "GRAPHDB_USERNAME": "username",
        "GRAPHDB_PASSWORD": "password"
      }
    }
  }
}

将这些值替换为你的 GraphDB 配置。

安装

# Clone the repository
git clone https://github.com/keonchennl/mcp-server-graphdb.git
cd mcp-server-graphdb

# Install dependencies
yarn install

# Build the project
yarn build

SPARQL 查询示例

以下是可以通过此服务运行的一些 SPARQL 查询示例：

1. 列出本体中的所有类：

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
SELECT DISTINCT ?class ?label
WHERE {
  { ?class a rdfs:Class } UNION { ?class a owl:Class }
  OPTIONAL { ?class rdfs:label ?label }
}
ORDER BY ?class

2. 列出特定类的所有属性：

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
SELECT ?property ?label ?range
WHERE {
  ?property rdfs:domain <http://example.org/YourClass> .
  OPTIONAL { ?property rdfs:label ?label }
  OPTIONAL { ?property rdfs:range ?range }
}
ORDER BY ?property

3. 按类统计实例数量：

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
SELECT ?class (COUNT(?instance) AS ?count)
WHERE {
  ?instance a ?class
}
GROUP BY ?class
ORDER BY DESC(?count)

许可证

此 MCP 服务采用 GPL-3.0 许可证。你可以自由使用、修改和分发此软件，但须遵守 GNU GPL-3.0 许可证的条款和条件。