MCP Graphdb

🚀 圖數據庫 MCP 服務器

本服務器基於模型上下文協議（Model Context Protocol），提供對 Ontotext GraphDB 的只讀訪問。它能助力大型語言模型（LLMs）探索 RDF 圖，並針對 GraphDB 實例執行 SPARQL 查詢。

🚀 快速開始

本圖數據庫 MCP 服務器允許大型語言模型（LLMs）探索 RDF 圖並執行 SPARQL 查詢。以下為你介紹其組件、配置、使用示例等內容。

✨ 主要特性

• 提供 Ontotext GraphDB 的只讀訪問，供大型語言模型使用。
• 具備多種工具，可執行 SPARQL 查詢、列出可用圖等。
• 提供倉庫數據的多個視圖，方便查看各類信息。
• 支持通過環境變量或命令行參數進行配置。

📦 安裝指南

1. 下載服務器代碼到目標目錄。
2. 在終端中運行安裝命令：

   npm install
   

3. 啟動服務器：

   node dist/index.js <GraphDB Endpoint> <Repository Name>
   

💻 使用示例

基礎用法

示例 1: 基本 SPARQL 查詢

SELECT * WHERE { ?subject ?predicate ?object }

示例 2: 列出所有圖

運行以下命令：

./listGraphs.sh

📚 詳細文檔

組件

工具

• 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"
      }
    }
  }
}

📄 許可證

此項目遵循 Apache 2.0 許可證。