AI导哈

知识图谱服务

一个将Data Graphs知识图谱平台暴露给AI助手的MCP服务器，支持Claude、ChatGPT等MCP兼容客户端。

  • by datalanguage
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 datalanguage/datagraphs-mcp-server

使用说明

@数据语言/数据图mcp服务器

一 MCP（模型上下文协议） 暴露的服务器 数据图表 知识图平台，用于Claude、ChatGPT、Cursor和其他MCP兼容客户端等AI助手。

先决条件

  • Node.js 18+
  • 一个带有API键的数据图项目

安装

npm install @datalanguage/datagraphs-mcp-server

或者直接使用npx运行：

npx @datalanguage/datagraphs-mcp-server

配置

获取凭证

要生成API密钥、客户端ID和客户端机密，请执行以下操作：

  1. 登录数据图并打开您的项目。
  2. 点击 管理项目.
  3. 首选 应用程序 然后单击 添加应用程序.
  4. 创建应用程序后，将显示API密钥、客户端ID和客户端机密。

重要提示： 显示客户端机密 仅一次 在创建时。立即复制它并将其存储在安全的地方——如果丢失，您需要轮换凭据或创建一个新的应用程序来获取新的密钥。

您的项目ID也可以在数据图的项目页面上找到。

环境变量

服务器从环境变量中读取凭据：

变量 必填 描述
DATAGRAPHS_PROJECT_ID 是 您的数据图项目ID
DATAGRAPHS_API_KEY 是 用于身份验证的API密钥
DATAGRAPHS_CLIENT_ID 对于GQL OAuth客户端ID（需要 graph_search)
DATAGRAPHS_CLIENT_SECRET 对于GQL OAuth客户端密钥（需要 graph_search)

MCP客户端设置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

克劳德代码

claude mcp add datagraphs -- npx -y @datalanguage/datagraphs-mcp-server

然后在启动Claude Code之前，在shell中设置所需的环境变量。

光标

添加到光标MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

工具

服务器提供以下工具：

列表_数据集

列出数据图项目中可用的所有数据集。

参数 类型 说明
pageSize number 每页结果数
pageNo number 要返回的页码

搜索概念

使用文本查询、过滤器和方面跨数据集搜索概念（节点）。

参数 类型 说明
dataset string 要搜索的数据集ID（默认为所有数据集）
q string 文本搜索查询
filter string NQL筛选器表达式
facets string[] 返回其方面计数的属性名称
pageSize number 每页结果数（默认值10）
pageNo number 要返回的页码（默认为1）
sort string 排序顺序，例如。 name:asc,modified:desc
embed string[] 要嵌入的关系属性（使用 ["_all"] 全部嵌入）
fields string[] 每个概念要返回的特定字段
includeDateFields boolean 包括创建日期和上次修改日期

get_concept

通过其URN标识符获取单个概念（节点）。

参数 类型 说明
id string 概念URN，例如。 urn:project:Type:identifier
embed string[] 要嵌入的关系属性（使用 ["_all"] 全部嵌入）
fields string[] 要返回的特定字段
includeDateFields boolean 包括创建日期和上次修改日期

图表搜索

对知识图执行GQL图查询。需要 DATAGRAPHS_CLIENT_ID 和 DATAGRAPHS_CLIENT_SECRET.

参数 类型 说明
query string GQL查询，例如。 MATCH (n:Person) RETURN n LIMIT 10

搜索交易

在事务/审计日志中搜索项目。

参数 类型 说明
filter string NQL筛选器表达式
pageSize number 每页结果数
pageNo number 要返回的页码
sort string 排序顺序，例如。 property:asc

get_model

获取项目的当前活动数据模型。不接受任何参数。

发展

git clone <repo-url>
cd datagraphs-client-mcp-server
npm install
npm start

许可证

无执照的

相关 MCP