dbt mcp serverをdbt coreに対して使う方法

2025-11-20 | 4 min read | engineering dbt bigquery mcp-server vscode

dbt core（dbt cloud使ってない）ユーザー向けのエディタでの設定。初期設定の情報が公式ドキュメント含めちょっと難しかったため残しておく

エディタのチャットで動かしてみたまでのメモ

環境

mac: 26.1
python: 3.11
uv: 0.6
dbt: 1.9

dbt-mcpの設定

ローカルセットアップの記事を参考にした。remote mcp serverのセットアップページもあるがこちらはdbt cloud向けのもの

https://docs.getdbt.com/docs/dbt-ai/setup-local-mcp

install

Install uv to be able to run dbt-mcp and related dependencies into an isolated virtual environment.

説明が簡素すぎてインストールからつまづいたが、uvコマンドをinstallして uvx dbt-mcp するとよい

と思ったけど、たいていエディタで設定して使うので、専用のページみると理解しやすい。この記事に書いていることはおおよそ書いてありそう

https://docs.getdbt.com/docs/dbt-ai/integrate-mcp-vscode

設定ファイル

envファイル

DBT_PROJECT_DIRはprefectと統合しているため、ルート内のdbt_project内においている DBT_PATHはuv使っているならば直下の.venv内にdbtコマンドのパスがあるはず

どちらも絶対パス

各種ツールのDISABLEはなくても良さそう(起動はする)けどなんとなくいれておく

# .env.dbt
 
DBT_PROJECT_DIR="/Users/uni/repos/prefect_workflows/dbt_project"
DBT_PATH="/Users/uni/repos/prefect_workflows/.venv/bin/dbt"
DBT_CLI_TIMEOUT=60 # default
DISABLE_SEMANTIC_LAYER=true
DISABLE_DISCOVERY=true
DISABLE_REMOTE_TOOLS=true
 
# for bigquery
BIGQUERY_PROJECT_ID="xxxx-xxxxxx"

接続先をbigqueryにしているのだが、dbt-mcpのlistツール実行時にエラーが出たので、envにBIGQUERY_PROJECT_IDを追加している

03:15:33 Encountered an error: Parsing Error Env var required but not provided: 'BIGQUERY_PROJECT_ID’

mcp serverの設定

mcp.jsonなどに追加。.envファイルの指定も絶対パス

{
    "servers": {
        "dbt-mcp": {
            "command": "uvx",
            "args": [
                "--env-file",
                "/Users/uni/repos/configs/.env.dbt",
                "dbt-mcp"
            ]
        }
    }
}