Dgraph MCP Server

🚀 Dgraph MCP 服務器

這是一個藉助 mcp-go 庫實現的 Dgraph 圖數據庫的模型上下文協議（MCP）服務器，可助力大語言模型（LLM）應用程序與 Dgraph 數據庫進行交互。

🚀 快速開始

此項目實現了與 Dgraph 數據庫交互的 MCP 服務器，允許大語言模型（LLM）應用程序執行 DQL 查詢、突變操作、修改架構以及獲取當前架構等操作。

✨ 主要特性

• 支持大語言模型（LLM）應用程序執行 DQL 查詢。
• 允許執行突變操作，對數據庫數據進行修改。
• 能夠修改 Dgraph 數據庫的架構。
• 可以獲取當前 Dgraph 數據庫的架構。

📦 安裝指南

先決條件

• Go 1.18 或更高版本。
• 運行中的 Dgraph 數據庫（本地或遠程）。

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴項：

go mod download

⚙️ 配置說明

服務器可以通過環境變量進行配置：

• DGRAPH_HOST：Dgraph 服務地址（默認：localhost:9080）

💻 使用示例

運行服務器

go run main.go

該服務器使用標準輸入/輸出與 LLM 應用程序通信。

可用工具

1. dgraph_query

對 Dgraph 執行 DQL 查詢。

• 參數：
  • query（字符串，必填）：要執行的 DQL 查詢。
  • variables（對象，可選）：查詢中的變量。
• 示例：

{
  "tool": "dgraph_query",
  "params": {
    "query": "{ me(func: has(name)) { name } }"
  }
}

2. dgraph_mutate

對 Dgraph 執行突變操作。

• 參數：
  • mutation（字符串，必填）：要執行的 RDF 突變。
  • commit（布爾值，可選）：是否提交事務（默認：true）。
• 示例：

{
  "tool": "dgraph_mutate",
  "params": {
    "mutation": "_:person <name> \"John Doe\" .",
    "commit": true
  }
}

3. dgraph_alter_schema

修改 Dgraph 的架構。

• 參數：
  • schema（字符串，必填）：要應用的架構定義。
• 示例：

{
  "tool": "dgraph_alter_schema",
  "params": {
    "schema": "name: string @index(exact) ."
  }
}

可用資源

1. dgraph://schema

返回當前 Dgraph 架構。

集成到 LLM 應用程序中

此服務器可以與任何支持 MCP 協議的 LLM 框架集成。服務器通過標準輸入/輸出進行通信，使其與各種 LLM 工具框架集成變得簡單易行。

示例查詢

基本查詢

{
  people(func: has(name)) {
    name
    age
    friends {
      name
    }
  }
}

添加數據

_:alice <name> "Alice" .
_:alice <age> "30" .
_:bob <name> "Bob" .
_:bob <age> "32" .
_:alice <friend> _:bob .

架構定義

name: string @index(exact) .
age: int .
friend: [uid] .

📄 許可證

本項目採用 MIT 許可證。