云开发基础能力 MCP 接入

支持通过 MCP 协议来管理云开发基础能力，包括云开发环境管理、静态网站部署，数据库集合管理、数据库文档操作等。

前往云开发平台运行 MCP Server

🚀 专为 AI 编程助手优化：认识 CloudBase-AI-ToolKit

如果您正在使用 Cursor、VSCode GitHub Copilot、Claude Code 等 AI 编程工具，我们强烈推荐您直接使用 CloudBase-AI-ToolKit！

CloudBase-AI-ToolKit 是一个专为本地 IDE 开发流程设计的上层应用。它封装了本项目的底层能力，为您提供无缝的智能开发体验：

🤖 AI 生成即部署：让您的 AI 编程助手不仅能写代码，更能直接生成可部署的全栈应用、小程序项目。
☁️ 一键发布上云：在 IDE 中与 AI 对话完成开发后，一键将应用发布到腾讯云开发 CloudBase，免去所有繁琐配置。

简单来说，CloudBase-AI-ToolKit 是您在 本地 IDE 中使用 AI 驱动云开发的最佳选择。本项目（cloudbase-mcp）则是其背后的核心引擎。

👉 前往 CloudBase-AI-ToolKit，开启您的 AI 云开发之旅！

功能特点

☁️ 云开发环境管理：提供获取所有云开发环境信息、获取环境合法域名列表、添加和删除安全域名、获取和修改当前环境信息等功能。
💻 数据库集合管理：支持创建、检查存在、更新、获取详细信息、列出集合、检查索引存在、查询数据分布等数据库集合相关操作。
📒 数据库文档操作：可向集合中插入文档、查询文档、更新文档、删除文档。
🌍 静态托管管理：实现上传文件到静态网站托管、获取文件列表、删除文件或文件夹、搜索文件、绑定和解绑自定义域名、获取静态网站配置、检查域名配置、修改域名配置等功能。
💻临时文件管理：能在临时目录创建文件，支持文本内容或 base64 编码的二进制内容；读取临时目录中的文件，支持文本和二进制文件。

使用示例

使用说明

远程 MCP

本项目支持一键部署到腾讯云开发平台，提供远程 SSE 访问

☁️ 前往云开发平台部署 MCP Server

部署完毕之后，可参考页面中的使用 MCP 说明，使用远程 SSE 访问 MCP Server。

本地 MCP

在支持 MCP 的本地客户端运行时，也可以使用通过 npx 来调用 cloudbase-mcp 工具。


{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp"],
      "env": {
        "TENCENTCLOUD_SECRETID": "腾讯云 SecretId",
        "TENCENTCLOUD_SECRETKEY": "腾讯云 SecretKey",
        "TENCENTCLOUD_SESSIONTOKEN": "腾讯云临时密钥Token，如果使用临时密钥才需要传入",
        "CLOUDBASE_ENV_ID": "云开发环境 ID"
      }
    }
  }
}

环境变量

需要将 TENCENTCLOUD_SECRETID 和 TENCENTCLOUD_SECRETKEY / TENCENTCLOUD_SESSIONTOKEN配置为您在云开发控制台获取的 SecretId 和 SecretKey （获取腾讯云 API 密钥）
需要将 CLOUDBASE_ENV_ID 配置为您在云开发控制台获取的环境 ID, 获取云开发环境 ID

🗺️ 功能清单

云开发环境管理

工具标识	功能描述	核心参数
`listEnvs`	获取所有云开发环境信息	无
`getEnvAuthDomains`	获取云开发环境的合法域名列表	无
`createEnvDomain`	为云开发环境添加安全域名	`domains`（必填，安全域名数组）
`deleteEnvDomain`	删除云开发环境的指定安全域名	`domains`（必填，安全域名数组）
`getEnvInfo`	获取当前云开发环境信息	无
`updateEnvInfo`	修改云开发环境别名	`alias`（必填，环境别名）

数据库集合管理

工具标识	功能描述	核心参数
`createCollection`	创建一个新的云开发数据库集合	`collectionName`（必填，集合名称）
`checkCollectionExists`	检查云开发数据库集合是否存在	`collectionName`（必填，集合名称）
`updateCollection`	更新云开发数据库集合配置（创建或删除索引）	`collectionName`（必填，集合名称），`options`（必填，更新选项，支持创建和删除索引）
`describeCollection`	获取云开发数据库集合的详细信息	`collectionName`（必填，集合名称）
`listCollections`	获取云开发数据库集合列表	`offset`（选填，偏移量），`limit`（选填，返回数量限制）
`checkIndexExists`	检查索引是否存在	`collectionName`（必填，集合名称），`indexName`（必填，索引名称）
`distribution`	查询数据库中集合的数据分布情况	无

数据库文档操作

工具标识	功能描述	核心参数
`insertDocuments`	向集合中插入一个或多个文档	`collectionName`（必填，集合名称），`documents`（必填，要插入的文档数组，每个文档为 JSON 字符串）
`queryDocuments`	查询集合中的文档	`collectionName`（必填，集合名称），`query`（选填，查询条件，JSON 字符串），`projection`（选填，返回字段投影，JSON 字符串），`sort`（选填，排序条件，JSON 字符串），`limit`（选填，返回数量限制），`offset`（选填，跳过的记录数）
`updateDocuments`	更新集合中的文档	`collectionName`（必填，集合名称），`query`（必填，查询条件，JSON 字符串），`update`（必填，更新内容，JSON 字符串），`isMulti`（选填，是否更新多条记录），`upsert`（选填，是否在不存在时插入）
`deleteDocuments`	删除集合中的文档	`collectionName`（必填，集合名称），`query`（必填，查询条件，JSON 字符串），`isMulti`（选填，是否删除多条记录）

静态托管管理

工具标识	功能描述	核心参数
`uploadFiles`	上传文件到静态网站托管	`localPath`（选填，本地文件或文件夹路径），`cloudPath`（选填，云端文件或文件夹路径），`files`（选填，多文件上传配置），`ignore`（选填，忽略文件模式）
`listFiles`	获取静态网站托管的文件列表	无
`deleteFiles`	删除静态网站托管的文件或文件夹	`cloudPath`（必填，云端文件或文件夹路径），`isDir`（选填，是否为文件夹，默认为 `false`）
`findFiles`	搜索静态网站托管的文件	`prefix`（必填，匹配前缀），`marker`（选填，起始对象键标记），`maxKeys`（选填，单次返回最大条目数）
`createHostingDomain`	绑定自定义域名	`domain`（必填，自定义域名），`certId`（必填，证书 ID）
`deleteHostingDomain`	解绑自定义域名	`domain`（必填，自定义域名）
`getWebsiteConfig`	获取静态网站配置	无
`tcbCheckResource`	检查域名配置	`domains`（必填，域名列表）
`tcbModifyAttribute`	修改域名配置	`domain`（必填，域名），`domainId`（必填，域名 ID），`domainConfig`（必填，域名配置）

临时文件管理

工具标识	功能描述	核心参数
`createTempFile`	在临时目录创建文件，支持文本内容或 base64 编码的二进制内容	`content`（必填，文件内容，可以是普通文本或 base64 编码的二进制内容），`isBase64`（选填，是否为 base64 编码，默认为 `false`），`extension`（选填，文件扩展名，如 `.txt`, `.png` 等）
`readTempFile`	读取临时目录中的文件，支持文本和二进制文件	`filePath`（必填，文件路径），`asBase64`（选填，是否以 base64 格式返回内容，默认为 `false`）