GraphDB MCP Server

GraphDB MCP 服务

概述

这是一个模型上下文协议（MCP）服务实现，提供数据库交互功能，并支持通过 GraphDB 探索图数据。 此服务支持运行 SPARQL 图查询。

组件

工具

此服务提供以下核心工具：

• read-graphdb-sparql

  • 执行 SPARQL 只读查询，从存储库中读取数据
  • 输入：
    • query（字符串）：要执行的 SPARQL 查询
  • 返回：序列化为 JSON 的查询结果对象数组

• get-graphdb-schema

  • 获取定义 GraphDB 数据库本体的 RDF 三元组列表
  • 无需输入
  • 返回：序列化为 JSON 的 RDF 三元组列表，这些三元组定义了 GraphDB 数据库的本体

在 Claude Desktop 中使用

"mcpServers": {
    "mcp-graphdb": {
        "command": "uvx",
        "args": [
            "D:\\Source\\mcp\\mcp-graphdb",
            "--db-url",
            "http://localhost:7200/repositories/starwars",
            "--schema-file",
            "D:\\Source\\mcp\\mcp-graphdb\\data\\starwars-ontology.trig",
            "--username",
            "ignore",
            "--password",
            "ignore"
        ]
    }
}

开发

先决条件

1. 安装 uv（通用虚拟环境）：

# Using pip
pip install uv

# Using Homebrew on macOS
brew install uv

# Using cargo (Rust package manager)
cargo install uv

2. 克隆仓库并设置开发环境：

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

# Create and activate virtual environment using uv
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install dependencies
uv pip install -e .

开发配置

# Add the server to your claude_desktop_config.json
"mcpServers": {
    "mcp-graphdb": {
        "command": "uvx",
        "args": [
            "D:\\Source\\mcp\\mcp-graphdb",
            "--db-url",
            "http://localhost:7200/repositories/starwars",
            "--schema-file",
            "D:\\Source\\mcp\\mcp-graphdb\\data\\starwars-ontology.trig",
            "--username",
            "ignore",
            "--password",
            "ignore"
        ]
    }
}

数据

此项目使用经过修改的 Star Wars 本体及一些实例数据。原始数据由 Nick Drummand 维护：

https://nickdrummond.github.io/star-wars-ontology/

博客文章

我写了一篇博客文章，介绍创建和使用此 MCP 服务的经验：

https://medium.com/@ianormy/mcp-for-graphdb-d3d3cd00cd4e

许可证

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