GraphDB MCP 服务器

一个模型上下文协议服务器，提供对 Ontotext GraphDB 的只读访问。该服务器使 LLM 能够探索 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 配置。

安装

# 克隆存储库
git clone https://github.com/yourname/mcp-server-graphdb.git
cd mcp-server-graphdb

# 安装依赖项
yarn install

# 构建项目
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 服务器是在 MIT 许可证下授权的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。