MCP Server Datahub

🚀 mcp-server-datahub

このプロジェクトは、モデルコンテキストプロトコル を DataHub 上で実装したサーバです。これにより、AI エージェントが 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）
• 個人用アクセストークン

uvx --from acryl-datahub datahub init

💻 使用例

クラウドデスクトップでの使用

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）に置き換えます。

📚 ドキュメント

詳細情報については、開発ドキュメント を参照してください。