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": "<full-path-to-uvx>",  // 例如：/Users/hsheth/.local/bin/uvx
      "args": ["mcp-server-datahub"],
      "env": {
        "DATAHUB_GMS_URL": "<your-datahub-url>",
        "DATAHUB_GMS_TOKEN": "<your-datahub-token>"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "datahub": {
      "command": "uvx",
      "args": ["mcp-server-datahub"],
      "env": {
        "DATAHUB_GMS_URL": "<your-datahub-url>",
        "DATAHUB_GMS_TOKEN": "<your-datahub-token>"
      }
    }
  }
}

其他 MCP 客户端

command: uvx
args:
  - mcp-server-datahub
env:
  DATAHUB_GMS_URL: <your-datahub-url>
  DATAHUB_GMS_TOKEN: <your-datahub-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。

📚 详细文档

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