dbt MCP サーバー

このMCP（モデルコンテキストプロトコル）サーバーは、dbtと連携するためのツールを提供します。詳細については、こちらのブログをご覧ください。

建築

Related MCP server: mcp-twitter

設定

1. リポジトリをクローンします。

git clone https://github.com/dbt-labs/dbt-mcp.git
cd dbt-mcp

2. uvをインストールする

3. インストールタスク

4. task installを実行

5. 環境変数を設定します。

cp .env.example .env

次に、特定の環境変数を使用して.env編集します ( README.mdのConfigurationセクションを参照)。

構成

MCP サーバーは次の構成をとります。

ツールグループ

検出およびセマンティック層の構成

リモートツールの構成

dbt CLI の設定

MCPクライアントでの使用

インストールが完了すると、MCP クライアントでサーバーを使用できるようになります。

この設定は、それぞれのクライアントの設定ファイルに追加されます。 <>内のセクションを必ず置き換えてください。

 {
  "mcpServers": {
    "dbt-mcp": {
      "command": "<path-to-mcp-executable>",
      "args": [
        "run",
        "<path-to-this-directory>/src/dbt_mcp/main.py"
      ]
    }
  }
}

<path-to-mcp-executable> OS によって異なります。

• Linux および Mac: <path-to-this-directory>/.venv/bin/mcp

• PC: <path-to-this-directory>/.venv/Scripts/mcp

クロードデスクトップ

次の手順に従って、 claude_desktop_config.jsonファイルを作成し、接続します。

Mac では、Claude Desktop のログは~/Library/Logs/Claudeにあります。

カーソル

1. カーソルメニューを開き、設定→カーソル設定→MCPを選択します。

2. 「新しいグローバルMCPサーバーを追加」をクリックします

3. 上記の設定を提供されたmcp.jsonファイルに追加します。

4. MCPタブ内で接続がアクティブであることを確認します

カーソルMCPドキュメントはここを参照してください

VSコード

1. 設定メニュー（コマンド+カンマ）を開き、ページ上部にある使用ケースに適したタブを選択します。

   • Workspace - ワークスペースのコンテキストでサーバーを構成します

   • User - ユーザーのコンテキストでサーバーを構成します

   • WSLユーザーへの注意：VS CodeをWSLで使用している場合は、WSL固有の設定を行う必要があります。コマンドパレット（F1）から**「Preferences: Open Remote Settings」コマンドを実行するか、設定エディターで「Remote」**タブを選択してください。ローカルユーザー設定はWSLで再利用されますが、WSL固有の設定で上書きできます。ローカルユーザー設定でMCPサーバーを設定しても、WSL環境では正しく動作しません。

2. 機能を選択→チャット

3. 「Mcp」がEnabledことを確認する

4. 「Mcp > Discovery」の下にある「settings.jsonで編集」をクリックします。

5. 提供されたsettings.jsonファイルに、サーバー構成( dbt )をサーバーの1つとして追加します。

{
    "mcp": {
        "inputs": [],
        "servers": {
          "dbt": {
            "command": "<path-to-mcp-executable>",
            "args": ["run", "<path-to-this-directory>/src/dbt_mcp/main.py"]
          }
        }
    }
}

<path-to-mcp-executable> OS によって異なります。

• Linux および Mac: <path-to-this-directory>/.venv/bin/mcp

• PC: <path-to-this-directory>/.venv/Scripts/mcp

6. MCP サーバーは、次の方法で起動、停止、および構成できます。

• コマンドパレット（Control + Command + P）からMCP: List Serversコマンドを実行し、サーバーを選択します。

• settings.jsonファイル内のキーワードをインラインで利用する

VS Code MCPドキュメントはこちらをご覧ください

ツール

dbt CLI

• build - モデル、テスト、スナップショット、シードを依存関係の順序で実行します

• compile - モデル、テスト、分析を実行せずに実行可能なSQLを生成します。

• docs - dbt プロジェクトのドキュメントを生成します

• ls (リスト) - モデルやテストなどの dbt プロジェクト内のリソースを一覧表示します

• parse - プロジェクトのファイルを解析して構文の正確性を検証します

• run - モデルを実行してデータベースに具体化する

• test - データとモデルの整合性を検証するためのテストを実行します

• show - データウェアハウスに対してクエリを実行します

クライアントがこのMCPツールを通じてdbtコマンドを使用することを許可すると、データモデル、ソース、ウェアハウスオブジェクトが変更される可能性があります。クライアントを信頼でき、潜在的な影響を理解している場合のみ、続行してください。

セマンティックレイヤー

• list_metrics - 定義されたすべてのメトリックを取得します

• get_dimensions - 指定された指標に関連付けられたディメンションを取得します

• get_entities - 指定されたメトリックに関連付けられたエンティティを取得します

• query_metrics - オプションのグループ化、順序付け、フィルタリング、制限を使用してメトリックをクエリします

発見

• get_mart_models - すべてのマートモデルを取得します

• get_all_models - すべてのモデルを取得する

• get_model_details - 特定のモデルの詳細を取得します

• get_model_parents - 特定のモデルの親ノードを取得します

• get_model_children - 特定のモデルの子モードを取得します

貢献

参加方法については、 CONTRIBUTING.mdをご覧ください。