Dgraph MCP Server

Dgraph MCP 服务

基于 mcp-go 库构建的 Dgraph 图数据库模型上下文协议（MCP）服务实现。

概述

本项目实现了一个 MCP 服务，支持大模型应用与 Dgraph 数据库交互。它提供以下工具：

• 执行 DQL 查询
• 执行变更
• 修改架构
• 获取当前架构

前提条件

• Go 1.18 或更高版本
• Dgraph 数据库（本地或远程运行）

安装

1. 克隆此仓库
2. 安装依赖项：

go mod download

配置

可以使用环境变量配置服务：

• DGRAPH_HOST：Dgraph 主机地址（默认值：localhost:9080）

使用方法

运行服务

go run main.go

服务使用标准输入/输出与大模型应用通信。

可用工具

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 架构。

与大模型应用集成

本服务可与任何支持模型上下文协议（MCP）的大模型应用集成。服务通过标准输入/输出进行通信，因此易于与各种大模型框架集成。

查询示例

基本查询

{
  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