@数据语言/数据图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和客户端机密,请执行以下操作:
- 登录数据图并打开您的项目。
- 点击 管理项目.
- 首选 应用程序 然后单击 添加应用程序.
- 创建应用程序后,将显示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
cd datagraphs-client-mcp-server
npm install
npm start许可证
无执照的
