Mcp Server Datahub

🚀 mcp-server-datahub 中文版

mcp-server-datahub 是一个基于 模型上下文协议 在 DataHub 上的服务器实现。借助该实现，AI 代理能够对 DataHub 进行查询，从而获取数据生态系统的元数据和上下文信息。它同时支持 DataHub 核心版本和 DataHub 云版本，为不同使用场景提供了便利。

✨ 主要特性

• 支持搜索所有实体类型，并可使用任意过滤器进行精准筛选。
• 能够获取任何实体的元数据，满足多样化的数据查询需求。
• 可以遍历血缘图，涵盖上游和下游方向，清晰呈现数据流向。
• 可列出与数据集关联的 SQL 查询，方便数据管理与分析。

🎥 演示

您可以查看 演示视频，该视频由 Block 团队合作完成，能帮助您更直观地了解项目的使用方式和效果。

📦 安装指南

安装 uv

# 适用于 macOS 和 Linux。
curl -LsSf https://astral.sh/uv/install.sh | sh

找到身份验证信息

为了进行身份验证，您需要准备以下内容：

• 您的 DataHub 实例 URL，例如 https://tenant.acryl.io/gms
• 一个 个人访问令牌

uvx --from acryl-datahub datahub init

💻 使用示例

配置您的 MCP 客户端

以下示例因代理而异。

Claude Desktop

运行 which uvx 以找到 uvx 命令的完整路径。

在您的 claude_desktop_config.json 文件中添加以下内容：

{
"mcpServers": {
"datahub": {
"command": "",  // 例如：/Users/hsheth/.local/bin/uvx
"args": ["mcp-server-datahub"],
"env": {
"DATAHUB_GMS_URL": "",
"DATAHUB_GMS_TOKEN": ""
}
}
}
}

Cursor

在 .cursor/mcp.json 文件中添加以下内容：

{
"mcpServers": {
"datahub": {
"command": "uvx",
"args": ["mcp-server-datahub"],
"env": {
"DATAHUB_GMS_URL": "",
"DATAHUB_GMS_TOKEN": ""
}
}
}
}

其他 MCP 客户端

command: uvx
args:
- mcp-server-datahub
env:
DATAHUB_GMS_URL: 
DATAHUB_GMS_TOKEN: 

故障排除

spawn uvx ENOENT

完整的错误堆栈可能如下：

2025-04-08T19:43:07.657Z - error: Error: spawn uvx ENOENT
at ChildProcess.spawn (node:internal/child_process.js:407:11)
at Object.spawnSync (node:internal/child_process.js:472:11)
at Spawn-syncSpawn (file:///Users/hsheth/.config/chromium/Default/extensions/gppongmhjkannfkpmsamajpmgidpojnlp/6.30.0_198/core/index.js:153:223)

解决方法：将命令中的 uvx 替换为从系统中获得的实际路径，例如 /Users/hsheth/.local/bin/uvx。

📚 详细文档

如需了解更多信息，请参阅 开发文档。