🚀 mcp-server-datahub 中文版

mcp-server-datahub 是 模型上下文协议 在 DataHub 上的服务器实现。借助该实现，AI 代理能够查询 DataHub，获取数据生态系统的元数据和上下文信息。它同时支持 DataHub 核心版本和 DataHub 云版本。

✨ 主要特性

• 可搜索所有实体类型，并能使用任意过滤器进行筛选。
• 能够获取任何实体的元数据。
• 支持遍历血缘图，涵盖上游和下游方向。
• 可列出与数据集关联的 SQL 查询。

🎥 演示

您可以查看 演示视频，该视频由 Block 团队合作完成。

📦 安装指南

1. 安装 uv

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

2. 找到您的身份验证信息 为了进行身份验证，您需要以下内容：

   • 您的 DataHub 实例 URL，例如 https://tenant.acryl.io/gms
   • 一个 个人访问令牌
   备选方案：使用 ~/.datahubenv 进行身份验证

   您也可以使用 `~/.datahubenv` 文件来配置您的身份验证。最简单的方式是运行 `datahub init` 并按照提示操作。 ```bash 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。

📚 详细文档

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