dbt开发容器模板

dbt+MCP+Claude代码CLI开发容器模板

用于本地dbt设置（Cloud CLI或Fusion）的开发容器模板，用于连接和配置dbt MCP服务器和Claude Code CLI。

什么是开发容器？

• dev容器是一个Docker容器，专门配置为一个功能齐全、一致、隔离和可移植的开发环境
• 定义于 .devcontainer/devcontainer.json 在一个项目中
• 阅读更多关于他们的信息：
  • VS代码文档
  • GitHub文档

使用容器的一般好处包括：

• 每个项目的独立环境（防止依赖关系和路径冲突）
• 可复制的构建和跨团队的一致环境，易于分发
• 为新贡献者提供更快的设置和入职流程
• 简化/开发，不影响您的主系统配置或其他项目

需求

• Docker桌面
• VS代码 随着 Dev容器 （或 远程资源管理器)扩展
• A. dbt 项目具有适当的：
  • dbt_project.yml 在工作区/项目文件夹根目录中
  • 在当地进行适当的配置 ~/.dbt 目录
• 开发者 专利审查高速路 来自dbt Cloud
• 无烟煤API证书
• 对于使用dbt高级用户的Cloud CLI，您需要提供 Altimate AI API密钥

特性

此开发容器将自动执行以下操作：

• 安装 dbt云命令行界面 或 dbt融合 取决于您选择的基础图像
• 配置 dbt MCP服务器
• 安装和配置 克劳德代码CLI
• 安装 dbt高级用户 扩展或 官方dbt VS代码扩展 取决于您选择的基础图像
• 安装 预提交
• 安装 紫外线

注意：所有工具和LLM都安装在临时开发容器本身中，并与您的计算机完全隔离。

安装说明

1. 将以下内容添加到您的项目中 .devcontainer/devcontainer.json 文件：

   • 对于Fusion： dbt Fusion开发容器JSON配置
   • 对于Cloud CLI： dbt Cloud CLI开发容器JSON配置

2. 将以下内容添加到您的项目中 .devcontainer/devcontainer.env 文件：

   • dbt MCP和Claude Code CLI所需的开发容器环境变量
   • 注：
     • 参见 dbt-mcp/README.md 用于环境变量配置
     • 您的Anthropic凭据环境变量将取决于您是使用默认的Anthrofic基URL还是第三方代理

3. 确认您的项目根目录中包含以下内容：

   复制

   .devcontainer
   ├── devcontainer.env  # Env vars
   └── devcontainer.json # Dev container config
   

4. 在VS Code中打开您的项目，并使用Dev Containers（或远程资源管理器）扩展来构建和运行容器。 (文档)

5. 给扩展安装一些时间

• 如果使用Fusion，请按照dbt的提示进一步安装可执行文件

验证安装

# Verify dbt
dbt --version
dbt debug

# Verify claude 
claude --version

# Verify dbt-mcp
claude
/mcp

# Verify pre-commit
pre-commit --version

# Verify uv
uv --version