Dbt Docs MCP

🚀 dbt ドキュメント MCP サーバー

モデルコンテキストプロトコル（MCP）サーバーは、dbt プロジェクトのメタデータ（manifest.json、catalog.json などの dbt Docs テキストアセット）とのやり取りに使用されます。このサーバーは dbt グラフ情報を提供し、ノードの詳細情報、モデル/列の血縁関係、および関連するメタデータのクエリを可能にします。

✨ 主な機能

このサーバーは以下のツールを提供します：

• dbt ノードの検索：

  • 名前でノード（モデル、ソース、テストなど）を検索します（search_dbt_node_names）。
  • 列名でノードを特定します（search_dbt_column_names）。
  • ノードのコンパイル済み SQL コード内を検索します（search_dbt_sql_code）。

• ノードの表示：

  • 任意のノードの一意の識別子から詳細属性を取得します（get_dbt_node_attributes）。

• 血縁関係の探索：

  • ノードの直接の上流依存関係（先行ノード）を見つけます（get_dbt_predecessors）。
  • ノードの直接の下流依存関係（後続ノード）を見つけます（get_dbt_successors）。

• 列レベルの血縁関係：

  • モデル内の特定の列のすべての上流ソースを追跡します（get_column_ancestors）。
  • モデル内の特定の列のすべての下流依存関係を追跡します（get_column_descendants）。

• 提案拡張：

  • SQL クエリを実行するツール。
  • データベースから直接テーブル/ビュー/列のメタデータを取得するツール。
  • 知識ベースを検索するツール。

🚀 クイックスタート

1. 前提条件： Python がインストールされており、uv が利用可能であることを確認してください。
2. リポジトリのクローン：

   git clone <repository-url>
   cd dbt-docs-mcp
   

3. オプション：列レベルの血縁関係を取得するために dbt 説明ファイルを解析する：
   • 必要な Python 環境を設定します。例えば：

   uv sync
   

   • 提供されているスクリプト scripts/create_manifest_cl.py を使用し、dbt 説明ファイル、dbt ディレクトリ、および必要な出力パスのスキーママッピングと説明 CL ファイルを指定します：

   python scripts/create_manifest_cl.py --manifest-path PATH_TO_YOUR_MANIFEST_FILE --catalog-path PATH_TO_YOUR_CATALOG_FILE --schema-mapping-path DESIRED_OUTPUT_PATH_FOR_SCHEMA_MAPPING --manifest-cl-path DESIRED_OUTPUT_PATH_FOR_MANIFEST_CL
   

   • dbt プロジェクトの規模によっては、列の血縁関係を生成するのに時間（数時間）がかかる場合があります。
4. サーバーの起動：
   • ターゲットの MCP クライアント（Claude デスクトップ、Cursor など）が mcp.json をサポートしている場合、以下のようにします：

   {
       "mcpServers": {
           "DBT ドキュメント MCP": {
           "command": "uv",
           "args": [
               "run",
               "--with",
               "networkx,mcp[cli],rapidfuzz,dbt-core,python-decouple,sqlglot,tqdm",
               "mcp",
               "run",
               "/Users/mattijs/repos/dbt-docs-mcp/src/mcp_server.py"
           ],
           "env": {
               "MANIFEST_PATH": "/Users/mattijs/repos/dbt-docs-mcp/inputs/manifest.json",
               "SCHEMA_MAPPING_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/schema_mapping.json",
               "MANIFEST_CL_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/manifest_column_lineage.json"
           }
           }
       }
   }