CloudBase AI ToolKit

@cloudbase/cloudbase-mcp

Tencent CloudBase 的 MCP 服务。 属于 CloudBase AI Toolkit。

通过 AI 编码工具操作 CloudBase：登录、数据库、函数、存储、托管和日志——通过 Model Context Protocol 实现。

English · 简体中文 · Toolkit README · 文档 · 更新日志 · 问题

此软件包的用途

@cloudbase/cloudbase-mcp 是 CloudBase MCP 服务的 npm 发行版。它是 Toolkit 的一部分：

如果 IDE 支持插件，建议优先使用插件。只有在需要 MCP 配置时，才单独使用此软件包。

Toolkit 的完整介绍、相关仓库和 IDE 列表请参阅：仓库 README。

快速开始

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

可以先尝试以下提示词：

Login to CloudBase

Use CloudBase Skills to build a todo app with login, database and permissions, then deploy

你需要一个 CloudBase 环境，并应确认 AI 提出的敏感操作。

其他安装方式

连接模式

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

选择与你的环境所在站点匹配的端点——两个站点使用独立的账号和凭证。

OAuth（交互式，推荐）：只需配置 URL——IDE 会打开浏览器供你登录并授权，然后你可在浏览器中选择环境。密钥不会写入配置文件，也无需轮换。

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
    }
  }
}

静态凭证（用于不支持 OAuth 的客户端和 CI/CD）：在端点后附加 env_id 和一组在同一站点创建的密钥。

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

静态密钥对会一直有效，直到轮换或删除；OAuth 会话则会在你退出登录时结束。仅在无法使用浏览器授权流程时才使用静态配置，并且不要将其提交到代码库。

本地：在你的计算机上运行 npx @cloudbase/cloudbase-mcp@latest——可使用完整功能，包括本地文件系统上传和模板下载。需要 Node.js v18.15.0+。

远程模式的取舍：无法使用本地文件系统功能（上传、模板下载），且国际站目前尚未提供 NoSQL 工具。

远程 URL 仅在一种情况下接受 site：位于 ap-singapore 的中国站环境（该区域存在歧义）。此外还接受 enable_plugins / disable_plugins（逗号分隔）。规范插件名称请参阅此程序包中的 src/server.ts（例如 env、database、functions、hosting、storage、pg_database、cloudrun、logs、feedback）。

可自托管的云模式：设置 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），以便为远程调用方禁用本地文件和进程工具。

站点与区域

设置 TCB_SITE（domestic / intl）以选择登录/凭证站点，并设置 TCB_REGION 进行 API 路由。国内站和国际站使用独立的账号系统。ap-singapore 同时属于两个站点，因此国内站新加坡用户必须设置 TCB_SITE=domestic；否则默认使用 intl。也支持项目级 .cloudbase/project.json（{ site, region, envId }）。

在远程模式下，站点由端点主机名决定——tcb-api.cloud.tencent.com 是中国站，tcb-api.tencentcloud.com 是国际站——且没有可供设置的 site 查询参数。位于 ap-singapore 的中国站环境也遵循此规则：继续使用中国站端点。可自托管的云模式部署仍可使用 TCB_SITE 环境变量。

实验性功能：MCP Apps 面板（默认关闭）

在支持 MCP Apps 的宿主中，auth、queryEnv 和部署工具可以呈现 MCP Apps 面板（ui://cloudbase/*）。此功能为实验性功能，且默认关闭：未设置环境变量时，不会注册任何 ui:// 资源，也不会有工具携带 _meta.ui，因此宿主会看到普通的 MCP 服务，结果仍为纯 JSON 文本。

将 CLOUDBASE_MCP_UI=on 设置为开启（也接受 1 / true / yes / enabled）。其他任何值——off、0、false、no、disabled 或拼写错误——都会保持关闭。无论开关状态如何，工具的行为都相同；此标志仅决定是否提供面板。

功能

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

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

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

执行破坏性调用前的确认

删除云函数、集合、集合中的文档、已存储的文件、CloudRun 服务或 MySQL 实例时，调用现在会暂停，直到你在对话框中确认目标——例如“即将删除云函数 hello（环境 env-abc）”——而不是只问一句“确定吗？”。当这些删除操作通过 callCloudApi 发起时，也会暂停，但仅针对明确的 service + Action 组合：tcb 或 scf 上的 DeleteFunction、tcb.DeleteTable、tcb.DeleteItem、tcb.DestroyEnv、tcb.DestroyPlatformEnv、tcb.DestroyMySQL、tcbr.DeleteCloudRunServer，以及 IsDeleteServer 为 true 时的 tcbr.DeleteCloudRunVersions。Delete 前缀不会触发对其他云 API 的确认。云存储删除操作不会通过 callCloudApi 发起。PostgreSQL 的 execute / applyMigration 仅在 SQL 语句本身为 DELETE、DROP、TRUNCATE 或 ALTER … DROP 时暂停；INSERT、UPDATE 和 CREATE TABLE 不会暂停。此功能基于 MCP 表单征询，因此只有在客户端声明了该能力且确实向用户发起询问时，才会显示确认对话框。

拒绝的调用不算失败：工具会返回“未执行”以及替代操作建议。有两个环境变量会改变处理方式，但都不会绕过身份验证、权限或只读限制——它们只决定是否发起询问：

客户端自己的工具审批提示不等同于此确认：前者询问“是否允许运行此工具？”，而不是“这是你想要删除的资源吗？”。

类凭据参数：写入前进行一次真实核对

当一次调用的参数中包含看起来像凭据的内容——三段式 JWT，或 cb_secret_… / cb_publishable_… 密钥——服务会在写入前请求客户端进行一次核对：对照你的原始来源比较该值并确认。此消息不包含明文：只包含总长度、各段长度（对于 JWT）以及指纹（sha256 的前 12 个十六进制字符）。这些信息足以发现复制或转录过程中值是否发生了变化，同时不会将密钥泄露到对话或日志中。

这不是什么。 我们不会判断凭据是否有效。这里没有签名验证、没有 certs/JWKS 查询、没有任何网络请求，也没有服务端比较——服务端看不到你最初粘贴的值，因此只有客户端能进行比较。这是在写入时请求真正确认，而不是进行有效性检查。

适用范围。 只有当参数确实包含类凭据字符串时才适用（否则调用保持不变：进行一次浅层扫描，不发起网络请求）。只有当客户端支持交互式表单征询时才适用；无法询问的客户端会照常继续，因此无人值守的客户端不会受阻。如果核对在几百毫秒内返回，就视为“无人查看”：与删除确认不同——客户端自行作答会被视为“没有询问你”，调用仍会继续——凭据写入不会执行，因为无人比较的值正是此机制要防范的情况。防护机制拒绝执行时，结果会说明“未执行”，但不会标记为错误，因此模型不会盲目重试。

入门面板（MCP Apps）

如果客户端声明了 io.modelcontextprotocol/ui 扩展，auth 还会打开一个只读小面板 （ui://cloudbase/get-started）。它会使用这次 auth 调用已经返回的结构化结果，并以通俗文字显示 连接状态——位置（站点及区域，例如“上海（中国）”）、访问范围和环境 ID——以及针对当前状态的一个主要操作（未登录时登录、未绑定环境时选择环境、准备就绪时接入示例项目）。面板唯一会调用的是只读的 auth(status)， 由“重新检查”触发；其他所有操作都只会将一句话发送到对话中，原始响应则折叠在“查看原始响应”中。

不渲染 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 配置。

文档

• 工具包 README
• 入门指南
• AI 插件
• 常见问题
• 更新日志

License

MIT · TencentCloudBase