跳到主要内容

云开发基础能力 MCP 接入

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

前往云开发平台运行 MCP Server

功能特点​

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

🔌 使用方式​

云开发 MCP 控制台