Bult.ai Mcp Server

@bultcloud/mcp-server

Bult.ai 的官方 Model Context Protocol (MCP) 服务。Bult.ai 是一个 DevOps 平台和云托管平台即服务，可借助 AI Agent 部署应用、GitHub 仓库、Docker 镜像、数据库和服务。

使用 Bult MCP 搭配 Claude Desktop、Claude Code、Cursor、Codex 和其他兼容 MCP 的客户端，通过 Bult API 部署应用、管理云基础设施、查看日志并排查部署问题。

演示

功能

• 从兼容 MCP 的 AI Agent 部署 GitHub 仓库、Docker 镜像、数据库和应用服务。
• 项目生命周期工具：列出、查看、创建、更新、删除、部署、启动、停止项目，以及丢弃更改。
• 管理守护进程和数据库服务，包括 Docker 镜像和基于 Git 的部署。
• 持久化卷、路由/域名映射、模板、服务日志和构建历史。
• 在支持的情况下，为只读、幂等和破坏性操作提供 MCP 工具注释。
• 可通过 stdio 与 Claude Desktop、Claude Code、Cursor、Google Antigravity 和其他兼容 MCP 的客户端配合使用。

何时使用 Bult MCP

如果你希望 AI 编码 Agent 替你部署和运维云托管资源，请使用 Bult MCP。常见工作流包括：从 Cursor 部署 GitHub 仓库、从 Claude Code 部署当前项目、启动 Docker 镜像、创建数据库服务、添加公共路由、查看构建日志，以及调试部署失败问题。

要求

• Node.js 18 或更高版本。
• Bult API 令牌。

安装

如果全局安装此软件包，请使用 bult-mcp 二进制文件：

npm install -g @bultcloud/mcp-server
bult-mcp

也可以在 MCP 客户端配置中使用 npx 运行：

npx -y @bultcloud/mcp-server

配置

服务从环境变量读取配置。

变量	必填	描述
BULT_API_URL	是	Bult API 基础 URL，https://app.bult.ai。
BULT_API_TOKEN	是	用于 Bearer 身份验证的 API 令牌。

如果缺少任一变量，服务会在启动时退出。

MCP 客户端设置

Claude Desktop

将服务添加到 claude_desktop_config.json。

使用 npx：

{
  "mcpServers": {
    "bult": {
      "command": "npx",
      "args": ["-y", "@bultcloud/mcp-server"],
      "env": {
        "BULT_API_URL": "https://app.bult.ai",
        "BULT_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

使用 npx：

claude mcp add bult \
  -e BULT_API_URL=https://app.bult.ai \
  -e BULT_API_TOKEN=your-token \
  -- npx -y @bultcloud/mcp-server

Codex CLI

使用 npx：

codex mcp add \
  --env BULT_API_URL=https://app.bult.ai \
  --env BULT_API_TOKEN=your-token \
  bult \
  -- npx -y @bultcloud/mcp-server

可用工具

项目

工具	描述
list-projects	列出工作区中的所有项目。
get-project	获取项目概览，包括服务、卷和路由。
create-project	创建新项目。
update-project	更新项目名称。
delete-project	删除项目及其所有资源。
deploy-project	部署项目更改并创建版本快照。
control-project	启动、停止项目或丢弃项目更改。

服务

工具	描述
list-services	列出项目中的所有服务。
get-service	获取服务详细信息和配置。
create-service	创建守护进程或数据库服务。
update-service	更新服务配置。
delete-service	删除服务。
control-service	启动、停止或重建服务。

卷

工具	描述
create-volume	创建持久化存储卷。
update-volume	更新卷名称或大小。
delete-volume	删除卷。
wipe-volume	不可逆地清除卷中的所有数据。

路由

工具	描述
create-route	为服务创建域名或路径映射。
update-route	更新路由配置。
delete-route	删除路由。

模板

工具	描述
list-templates	列出可用的项目模板。
apply-template	将模板应用到项目。

日志和构建

工具	描述
get-service-logs	使用基于游标的分页读取服务日志。
list-builds	列出服务的构建历史记录。

示例提示词

• 将这个 GitHub 仓库部署到 Bult，并提供公开 URL。
• 将当前项目部署到 Bult。
• 检查部署失败的原因。
• 显示我应用的最新日志。
• 设置 DATABASE_URL 并重启服务。
• 将这个 Docker 镜像部署到 Bult。
• 列出我的 Bult 项目和服务。

开发

npm run dev      # run with tsx, no build step
npm run build    # compile TypeScript to dist/
npm run lint     # type-check without emitting files

项目结构：

src/index.ts          MCP server entrypoint
src/client.ts         Bult API client
src/tools/*.ts        MCP tool registrations by resource type

安全

BULT_API_TOKEN 可用于访问你的 Bult 资源。请勿将其泄露到 源代码管理、Shell 历史记录、问题报告或屏幕截图中。如有可用的范围受限或 可轮换令牌，请优先使用。

某些工具可以创建、删除、部署、停止或清除资源。批准破坏性操作前， 请先检查 MCP 客户端发起的工具调用。

隐私政策

此 MCP 服务使用你提供的 API 令牌，将 MCP 客户端连接到 Bult.ai。请求会发送到 Bult.ai，以执行列出 项目、部署服务、管理路由和卷以及读取日志等操作。

此服务不会存储你的 API 令牌。令牌会通过 MCP 客户端配置或扩展设置传递。如需了解 Bult.ai 的数据处理惯例， 请参阅 Bult.ai 隐私政策。

贡献

欢迎在 github.com/bultcloud/mcp-server 提交问题和拉取请求。

提交拉取请求前，请运行：

npm run lint
npm run build

许可证

本项目采用 MIT 许可证 授权。