MCP Server Datahub

🚀 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。

📚 詳細文檔

如需瞭解更多信息，請參閱 開發文檔。