CloudBase MCP
Official把腾讯云 CloudBase 接入 AI IDE，让 AI 生成的应用从提示词一键部署上线。
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx @cloudbase/cloudbase-mcp@latestPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js v18.15.0 及以上版本（本地模式需能执行 npx）
- 已开通腾讯云开发环境（CloudBase 环境）
- 支持 MCP 的 AI IDE（Cursor、WindSurf、CodeBuddy、Claude Code、Gemini CLI 等）
- 托管/云端模式需提供腾讯云 API 密钥（SecretId / SecretKey）及环境 ID
About CloudBase MCP
CloudBase MCP 是腾讯云开发官方的 MCP 服务器，让 AI IDE 通过自然语言完成从代码生成到云端部署的完整闭环。它内置面向 AI 的规则库（生成符合云开发规范的可部署代码）、自动化部署流（自动检测项目类型并配置云函数/数据库/静态托管/云托管/CDN/域名）、智能调试（自动读日志分析报错并修复重部署）和云开发知识库向量检索。支持 Web 应用（React/Vue/Next.js）、微信小程序（原生/UniApp）和 Node.js/Python/Go/Java 后端服务。提供本地（npx stdio）、腾讯云托管（HTTP）和自建服务器（Cloud Mode）三种部署方式，可通过 enable_plugins/disable_plugins 按需启用插件。
Tools & capabilities (36)
authCloudBase 开发阶段登录与环境绑定：查询状态、发起登录、绑定环境(set_env)、退出登录、获取临时密钥。
queryEnv查询 CloudBase 环境信息：环境列表/摘要筛选、指定环境详情（含计费信息）、安全域名列表。
envDomainManagement管理环境的安全域名（CORS 白名单），支持添加和删除。
readNoSqlDatabaseStructure读取 NoSQL 数据库集合与索引结构：列出集合、集合详情、列出索引、检查索引存在性。
writeNoSqlDatabaseStructure创建、删除和管理 NoSQL 数据库集合（collection）。
readNoSqlDatabaseContent查询 NoSQL 数据库记录，支持按条件筛选、分页、排序。
writeNoSqlDatabaseContent修改 NoSQL 数据库记录，支持插入、更新（$set/$inc/$push 等）、删除、upsert。
manageDataModel数据模型只读查询工具，支持查询和列表数据模型。
modifyDataModel基于 Mermaid classDiagram 创建数据模型（当前仅支持创建新模型）。
queryPgDatabase查询 PostgreSQL 数据库：获取 PG 上下文、列出带 schema 的数据库对象、读取元数据、检查对象结构。
managePgDatabase管理 PostgreSQL MCP 上下文：绑定执行路径、本地开发环境初始化、SQL 风险预检、迁移规划。
queryPgStorage查询 PostgreSQL 环境下的云存储能力：bucket/config 能力摘要、对象信息查询、上传方案。
queryFunctions云函数统一只读入口：查询函数列表、详情、执行日志、层、触发器和代码。
manageFunctions云函数统一写入口：创建函数、更新代码/配置、调用函数、管理定时任务 timer。
queryHosting查询静态托管只读信息：首页/错误页/路由规则、站点域名等。
manageHosting管理静态托管变更操作：上传本地构建产物到共享域名等。
queryStorage查询云存储信息：列出目录文件、获取文件信息、获取临时下载链接等只读操作。
manageStorage管理云存储文件（COS/Storage 对象）：上传/下载/删除文件或目录。
downloadTemplate自动下载并部署 CloudBase 项目模板。
searchKnowledgeBase云开发知识库智能检索：向量查询、技能文档、OpenAPI 文档和官方文档检索。
queryCloudRun查询云托管服务信息：服务列表、服务详情、可用模板列表、部署日志。
manageCloudRun管理云托管服务：初始化项目、下载服务代码、本地运行、部署等。
queryGateway网关统一只读入口：查询网关域名、访问入口和目标暴露情况。
manageGateway网关统一写入口：创建目标访问入口，为 HTTP 云函数补默认网关配置。
queryAppAuth应用侧认证配置只读入口：查询登录方式、provider、publishable key、API key、client 配置等。
manageAppAuth应用侧认证配置写入口：修改登录方式、provider、client 配置，创建/删除 API key。
queryApps查询 CloudBase 应用部署的应用和版本，部署后按 buildId 轮询构建状态。
manageApps部署 Web 应用到 CloudBase（构建前后端，部署到独立子域名）。
queryPermissions查询权限与用户配置：资源权限（数据库/云函数/存储桶）、角色、应用用户。
managePermissions管理权限与用户配置：修改资源权限、角色管理、成员与策略增删、应用用户 CRUD。
queryLogs日志域统一只读入口：检查日志服务状态并搜索 CLS 日志。
queryAgentsAgent 域统一只读入口：列表、详情与日志查询。
manageAgentsAgent 域统一写入口：创建、更新和删除远端 Agent。
downloadRemoteFile下载远程文件到项目根目录下的指定相对路径（如小程序素材图片）。
activateInviteCode云开发 AI 编程激励计划，通过邀请码激活用户激励。
callCloudApi通用云 API 调用工具，用于 CloudBase / 腾讯云管控面及依赖资源相关 API 调用。
When to use it
- 用自然语言生成并一键部署全栈应用（如双人在线对战五子棋网站，含 Web 前端 + 云数据库 + 实时数据推送）
- 开发并发布微信小程序（如 AI 宠物养成小程序，含小程序 + 云数据库 + AI 云函数）
- 智能调试：应用报错时由 AI 自动读取云函数日志、分析错误原因、生成修复代码并重新部署
- 通过云开发知识库向量检索获取云数据库/小程序等专业文档与最佳实践代码示例
Security notes
本地模式（npx）下 MCP 服务运行在开发者本机，通过 stdio 与 AI IDE 通信，代码不会离开本机直到主动部署；部分工具（如 downloadRemoteFile、manageCloudRun run）本质等同于开发者在本机执行命令。若在远程服务器上自建部署，务必设置环境变量 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），启用后会自动禁用所有涉及本地文件读写和本地进程启动的工具（如 downloadRemoteFile、downloadTemplate、manageStorage、createFunction 等），防止远程调用方操作服务器本地资源；腾讯云托管模式（Streamable HTTP）已自动启用该保护。托管/云端模式需配置腾讯云 SecretId/SecretKey，均走 HTTPS 加密。
CloudBase MCP FAQ
跟 Vercel / Railway / Netlify 有什么不同？
这些平台解决的是「部署」，CloudBase MCP 解决的是「从 AI 生成代码到部署上线」的完整链路。无需离开 IDE、无需写配置文件，AI 自动搞定云函数、数据库、CDN、域名等所有云资源。
不用 Cursor / Copilot 这些 AI IDE 也能用吗？
可以。CloudBase MCP 基于标准 MCP 协议，支持所有兼容 MCP 的工具，包括 Claude Code、Gemini CLI、OpenCode 等命令行工具，只要能配置 MCP Server 即可使用。
我的代码会被上传到哪里？安全吗？
代码只会部署到你自己的腾讯云开发环境，不经过任何第三方。本地模式下 MCP 服务运行在本机，代码不会离开电脑直到主动部署，所有云端通信均走 HTTPS 加密。
在服务器上部署 MCP 服务是否安全？
需在远程服务器自建部署时务必设置 CLOUDBASE_MCP_CLOUD_MODE=true，启用后所有涉及本地文件读写和本地进程启动的工具均被禁用，远程调用方无法操作服务器本地资源；腾讯云托管模式（Streamable HTTP）已自动启用该保护。
免费吗？需要付费吗？
CloudBase MCP 工具本身完全开源免费（MIT）。云开发环境有免费额度，个人开发和小项目通常够用，超出后按量计费。
Alternatives to CloudBase MCP
Compare all alternatives →
GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.
Official AWS Labs server that lets agents call any AWS API via the AWS CLI surface.
Bulk Kubernetes port forwarding with an MCP server that lets AI assistants forward services, inspect pods, and monitor traffic.
Compare CloudBase MCP with: