@cloudbase/cloudbase-mcp

腾讯云开发 CloudBase 的 MCP Server。 属于 CloudBase AI Toolkit。

在 AI 编程工具里通过 Model Context Protocol 操作 CloudBase：登录、数据库、云函数、存储、托管与日志。

简体中文 · English · Toolkit 总览 · 文档 · 更新日志 · Issues

这个包是什么

@cloudbase/cloudbase-mcp 是 CloudBase MCP Server 的 npm 发行包，是 Toolkit 中的一块：

IDE 支持时优先用 Plugin；只需 MCP 配置时用本包即可。

完整 Toolkit 叙事、相关仓库与 IDE 列表见 仓库 README。

快速开始

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

首次提示：

登录云开发

用 CloudBase Skills 做一个带登录、数据库和权限的待办应用，然后部署

需要已开通 云开发环境，并对 AI 发起的敏感操作自行确认。

其他安装路径

已经在用 CloudBase CLI 的话，tcb ai 同样能配好 MCP 和 Skills（说明）。

连接方式

远端（推荐）：IDE 通过 HTTP 连接腾讯云 MCP，无需本机 Node，交互式客户端在浏览器里完成授权。

按环境所在站点选择地址——两个站点账号与凭证相互独立。

本地：在本机运行 npx @cloudbase/cloudbase-mcp@latest，功能最全（含本地文件上传、模板下载）。需 Node.js v18.15.0+。

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
        "X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
      }
    }
  }
}

远端模式有两种鉴权路径：

• OAuth（交互式，推荐）：只填 URL，IDE 会打开浏览器完成登录与授权，密钥不落配置文件。
• 静态凭证（CI/CD）：补上 env_id 与上面的 X-TencentCloud-* 请求头。

远端的取舍：依赖本地文件系统的能力（上传、模板下载）不可用；国际站暂未提供 NoSQL 相关工具。

远端 URL 可用 site，仅用于国内站账号的 ap-singapore 环境（该地域两站都有、服务端无法归属），另可用 enable_plugins / disable_plugins（逗号分隔）裁剪工具集。插件名见本包 src/server.ts（如 env、database、functions、hosting、storage、pg_database、cloudrun、logs）。

自建 Cloud Mode：设置 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），禁用面向远程调用方的本地文件/进程类工具。

站点与地域

用 TCB_SITE（domestic / intl）选择登录与凭证站点，TCB_REGION 控制 API 走哪个地域。国内站与国际站是两套独立账号体系。ap-singapore 在两个站点都存在，所以国内站新加坡的用户必须显式设置 TCB_SITE=domestic，否则会默认走国际站。也支持项目级 .cloudbase/project.json（{ site, region, envId }）。

远端模式下，站点由地址本身决定——tcb-api.cloud.tencent.com 是国内站，tcb-api.tencentcloud.com 是国际站，不需要也不应该再选。国内站环境落在 ap-singapore 也照样用国内站地址——远端没有 site 参数，站点只由域名决定。自建 Cloud Mode 部署仍可用 TCB_SITE 环境变量。

能力

在你的环境中完成常见后端工作（关键步骤请确认）：

• 数据库：PostgreSQL 与文档型数据库、数据模型、CRUD、权限
• 计算：云函数 / 云托管——编写、部署、调用、排障
• 认证与存储：登录方式、对象存储、与数据权限联动
• 发布与运维：静态托管 / 小程序发布；日志与重新部署

工具目录：MCP 工具 · tools.json

破坏性操作的执行前确认

删除云函数、集合、集合内的文档、云存储文件、云托管服务或 MySQL 实例时，调用会在执行前暂停，等你在确认框里选一次——框里写清这次要动什么（例如「即将删除云函数 hello（环境 env-abc）」），而不是只问一句"确定吗"。同一批删除如果改走 callCloudApi，也按写死的 service + Action 停下来确认：tcb/scf 的 DeleteFunction、tcb.DeleteTable、tcb.DeleteItem、tcb.DestroyEnv、tcb.DestroyPlatformEnv、tcb.DestroyMySQL、tcbr.DeleteCloudRunServer，以及 tcbr.DeleteCloudRunVersions 且 IsDeleteServer 为 true。不会按 Delete 前缀去拦其它云 API。云存储删除不走 callCloudApi。PostgreSQL 的 execute / applyMigration 只在语句本身是 DELETE、DROP、TRUNCATE 或 ALTER … DROP 时才停下来；INSERT / UPDATE / CREATE TABLE 不拦。它基于 MCP 的表单式 elicitation，所以只在声明了该能力、并且真的会问用户的客户端里出现。

被拒绝不等于失败：工具返回"未执行"以及可以改用别的做法。两个环境变量可以调整这套行为，它们都不绕过认证、权限或只读限制，只决定"问不问"：

客户端自己的"工具审批"框不是这个确认：它问的是"允不允许这个工具运行"，不是"你要删的就是这个资源吗"。

参数里出现凭证：写入前先做一次真实核对

当一次调用的参数里出现凭证形态的字符串——三段式 JWT，或 cb_secret_… / cb_publishable_… 开头的密钥——服务端会在写入前向客户端要一次核对：把这串与你手上的原始来源逐字比对，一致再确认。消息里刻意不放明文，只给总长度、分段长度（JWT）与指纹（sha256 的前 12 位十六进制）：这几样足够看出"复制或转写时被改过"，又不会把密钥带进对话或日志。

这不是什么。 我们不判断凭证是否有效：没有验签，不查 certs/JWKS，不发任何网络请求，服务端也不做比对——用户最初粘进来的那份服务端永远拿不到，能做比对的只有客户端。它只是"写入前要一次真实的确认"，不是有效性校验。

边界。 只有参数里真的出现凭证形态字符串时才会走到这一步（否则调用零变化：一次浅扫描、无网络）；只有客户端支持交互式表单 elicitation 时才生效，不支持干预式确认的客户端照常执行（不会把无人值守的客户端整个封死）；另外，几百毫秒内返回的核对一律按"没人看过"处理——与删除确认相反（那边客户端自己应答会被当作"你没被问到"而放行），凭证写入不执行，因为"没人比对过"正是它要挡的情况。被拦下时返回"未执行"，且不会被标记成错误，避免模型盲目重试。

环境面板（MCP Apps）

当客户端声明了 io.modelcontextprotocol/ui 扩展时，auth 会额外打开一个面板 （ui://cloudbase/get-started）。面板默认开启，CLOUDBASE_MCP_UI=off 可以关掉。 它直接消费这次 auth 调用已经送回来的结构化结果，展示连接状态 ——地域、范围与环境 ID。未登录时给出登录；已登录未绑定环境时，点列表中的一行即可绑定。

面板不会改动云端资源，但它不是只读的。它会发两类调用：

• auth(status) —— 只读，点「重新检查」触发。
• auth(set_env) —— 点环境那一行时触发。它只改本地会话绑定的环境（环境级 API Key 仍然切不到别的环境）， 但改完之后所有后续工具都按新环境走，所以那一行要有意识地选。

其余操作只是把一句话交给会话。带 credentials 的结果（例如 auth(get_temp_credentials) 开了 reveal） 不会打开「查看原始返回」，折叠区里不会出现密钥。

不渲染 MCP Apps 的客户端不受影响：auth 的标题、描述、参数与输出保持不变，resources/list 仍为空数组， 资源面板里不会多出任何新条目。

IDE 配置片段

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

其他：IDE 配置指南。

文档

• Toolkit 总览
• 快速开始
• AI 插件
• 常见问题
• 更新日志

许可证

MIT · TencentCloudBase