CloudBase AI Toolkit

官方

AI 写代码，CloudBase 跑后端。

分类: 数据库第 20 / 58
Stars: ★ 1.1k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 18.15.0+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 今天

59FMRS · C

CloudBase AI Toolkit 是腾讯官方的 MCP 服务器，与 CloudBase 后端服务深度集成，适合需要数据库、函数、存储和托管能力的 AI 编程场景。它提供了丰富的功能和多种安装方式，但需要警惕 AI 操作对数据的潜在风险。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

15/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 仓库提供了工具清单（scripts/tools.json）和命令行入口（npx @cloudbase/cloudbase-mcp），但未提供任何测试文件或CI配置来验证MCP握手和工具行为。README声称支持多种模式（本地、托管、云模式），但缺少可复现的验证证据。因此可靠性得分限制在8分，因为关键路径可信但未经测试。
安全与权限 13/20: 仓库提供了云模式环境变量（CLOUDBASE_MCP_CLOUD_MODE）以禁用本地文件/进程工具，并建议对敏感操作进行确认，但未提供代码层面的证据（如权限控制、确认机制）。未发现恶意行为或凭证泄露。由于未能在源码中验证最小权限和确认机制，且托管模式需要用户提供密钥，得分13分。
维护活跃度 15/20: 仓库活跃，有近期发布（v2.25.x）和明确的变更日志，MIT许可证清晰。npm包版本和下载徽章表明持续维护。但未提供安全响应渠道或依赖更新策略的证据。得分15分。
文档质量 13/20: README提供了详细的安装说明、多种IDE集成配置示例和FAQ，但工具参数、限制和成本信息主要在外部文档中，未能从仓库内验证。缺少故障排查的详细步骤。得分13分。
安装易用性 10/20: README提供了清晰的安装步骤和多种客户端配置示例（如MCP配置JSON），但依赖外部服务（CloudBase环境）和npm包，且未提供本地测试或验证步骤。由于缺少可复现的安装验证证据，设置得分限制在10分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络修改第三方账户数据连接数据库

适合谁

使用 AI 编程助手（如 Cursor、Claude Code）进行全栈开发并希望将后端托管在腾讯云的开发者
需要快速搭建带登录、数据库和权限的应用的团队
希望在聊天中完成环境配置、数据库操作和部署的开发人员

不适合谁

仅需要前端托管或静态站点部署而不需要后端数据库/函数的场景（此时可以仅使用 CloudBase 的其他插件）
不信任 AI 代理执行敏感操作且不能审查变更的用户（因为工具允许 AI 直接修改数据和权限）
不希望使用腾讯云服务的用户

所需权限

需要登录 CloudBase 并拥有环境的访问权限
能访问数据库、云函数、存储等资源的权限
可能需要创建数据库、修改安全规则等高级权限

风险与副作用

AI 可能执行破坏性操作，如删除数据或修改权限，务必事先备份
在本地模式运行时，工具运行在你的机器上，代码不会上传，但云流量使用 HTTPS
托管 HTTP 模式需要通过 HTTP 发送 SecretId/SecretKey，务必妥善保管并选用可信的传输环境

安装接入

准备工作

运行环境：Node.js 18.15.0+ · 远程托管（无需本地环境）

其他可选配置项（2 个）

CLOUDBASE_MCP_CLOUD_MODE 可选设为 true 时禁用本地文件/进程工具，自托管远程部署时必须开启；无需外部获取。

MCP_CLOUD_MODE 可选同 CLOUDBASE_MCP_CLOUD_MODE 的替代变量名，设为 true 进入云模式；无需外部获取。

确保已安装 Node.js v18.15.0 或更高版本，并拥有一个 CloudBase 环境。
推荐使用插件方式安装：npx plugins add TencentCloudBase/cloudbase-plugin。
或者使用 CloudBase AI CLI：npm i -g @cloudbase/cli && tcb ai。
也可以手动配置 MCP：在 IDE 的配置文件（如 .cursor/mcp.json）中添加 MCP 服务器配置。

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add cloudbase -- npx @cloudbase/cloudbase-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端连接后发送提示词 "Login to CloudBase"，若能完成登录并列出你的 CloudBase 环境，说明安装成功；也可在工具列表中确认出现 cloudbase 相关工具。

常见排障

如果登录提示环境不存在，请在 CloudBase 控制台确认环境存在且健康，然后重新登录
确保 Node.js 版本不低于 18.15.0
如果使用托管模式，检查环境变量 enable_plugins/disable_plugins 配置是否正确
检查 MCP 配置中的命令和参数是否正确（例如 `npx @cloudbase/cloudbase-mcp@latest`）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

登录到 CloudBase
使用 CloudBase Skills 搭建一个带登录、数据库和权限的 todo 应用，然后部署
创建一个云函数并部署后调用它
查看最近的云函数日志

使用场景

在聊天中直接操作 CloudBase 数据库（PostgreSQL 和文档数据库）

部署和调试云函数或 Cloud Run

管理对象存储和鉴权方式

部署静态网站或小程序

查看和获取云函数日志

支持客户端

Claude Code

Cursor

Codex

Gemini CLI

OpenCode

Windsurf

Trae

Tongyi Lingma

Roo Code

Cline

GitHub Copilot

Baidu Comate

Augment Code

OpenClaw

WorkBuddy

ZCode

CodeBuddy

依据项目文档列出，未经本站实测。

详细介绍

CloudBase AI Toolkit 是腾讯云 CloudBase 为 AI 编程工具提供的一体化后端集成层。它通过插件、技能（Skills）和 MCP 服务器，让 AI 编程助手能够直接操作 CloudBase 的数据库、云函数、对象存储、托管和鉴权等服务。MCP 服务器支持登录、增删改查数据、管理云函数和托管、读取日志等操作。本仓库提供 npm 包 @cloudbase/cloudbase-mcp，以及一系列技能和 AI 插件。