dbt MCP 服务器

此 MCP (模型上下文协议) 服务器提供 MCP 工具，以几种不同的方式与 dbt 交互。

目前，它允许用户：

• 从本地安装的 dbt Core 或 dbt Cloud CLI 运行命令
• 获取有关其模型以及给定 dbt 项目中配置的转换的信息
• 与 dbt Cloud Semantic Layer 网关交互，获取指标、维度列表并直接查询这些

架构

设置

1. 克隆存储库：

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

2. 安装 uv

3. 安装 Task

4. 运行 task install

5. 配置环境变量：

cp .env.example .env

然后使用您的特定环境变量编辑 .env：

• DISABLE_DBT_CLI：将其设置为 true 以禁用 dbt Core 和 dbt Cloud CLI MCP 对象。 否则，它们将被启用。
• DISABLE_SEMANTIC_LAYER：将其设置为 true 以禁用 dbt Semantic Layer MCP 对象。 否则，它们将被启用。
• DISABLE_DISCOVERY：将其设置为 true 以禁用 dbt Discovery API MCP 对象。 否则，它们将被启用。
• DBT_HOST：您的 dbt Cloud 实例主机名。 这看起来像此处找到的“访问 URL”。 如果您使用的是 Multi-cell，请不要在此处包含 ACCOUNT_PREFIX。
• MULTICELL_ACCOUNT_PREFIX：如果您使用的是 Multi-cell，请将其设置为您的 ACCOUNT_PREFIX。 如果您未使用 Multi-cell，请勿设置此环境变量。 您可以在此处了解更多信息。
• DBT_ENV_ID：您的 dbt 环境 ID。
• DBT_TOKEN：您的个人访问令牌或服务令牌。 使用 Semantic Layer 时需要服务令牌。
• DBT_PROJECT_DIR：您的 dbt 项目的路径。
• DBT_PATH：您的 dbt Core 或 dbt Cloud CLI 可执行文件的路径。 您可以通过运行 which dbt 找到您的 dbt 可执行文件。
• DBT_EXECUTABLE_TYPE：如果 DBT_PATH 环境变量指向 dbt Core，则将其设置为 core。 否则，假定为 dbt Cloud CLI。

与 MCP 客户端一起使用

完成设置后，您可以将服务器与 MCP 客户端一起使用。

此配置将添加到相应客户端的配置文件中：

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

请务必替换 <path-to-this-directory>

如果遇到任何问题。 您可以尝试运行 task run 以在终端中查看错误

Claude Desktop

按照这些说明创建 claude_desktop_config.json 文件并连接。

您可以在 ~/Library/Logs/Claude 找到 Claude Desktop 日志。

Cursor

1. 打开 Cursor 菜单并选择 Settings → Cursor Settings → MCP
2. 单击“Add new global MCP server”
3. 将上面的配置添加到提供的 mcp.json 文件中
4. 验证您的连接是否在 MCP 选项卡中处于活动状态

Cursor MCP 文档此处供参考

VS Code

1. 打开 Settings 菜单（Command + Comma）并在页面顶部选择适合您用例的选项卡

   • Workspace - 在您的工作区上下文中配置服务器
   • User - 在您的用户上下文中配置服务器

2. 选择 Features → Chat

3. 确保 "Mcp" 为 Enabled

4. 单击 "Mcp > Discovery" 下的 "Edit in settings.json"

5. 将您的服务器配置 (dbt) 作为服务器之一添加到提供的 settings.json 文件中

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

设置完成后，您可以通过以下方式启动、停止和配置您的 MCP 服务器：

• 从命令面板（Control + Command + P）运行 MCP: List Servers 命令并选择服务器
• 在 settings.json 文件中使用内联关键字

VS Code MCP 文档此处供参考

贡献

阅读 CONTRIBUTING.md 以获取有关如何参与的说明！