
腾讯云 COS MCP Server
无需编码即可让大模型接入腾讯云对象存储 (COS) 与数据万象 (CI) 的存储与处理能力。
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx cos-mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"cos-mcp-server": {
"command": "npx",
"args": [
"cos-mcp",
"--Region=yourRegion",
"--Bucket=yourBucket",
"--SecretId=yourSecretId",
"--SecretKey=yourSecretKey",
"--DatasetName=yourDatasetname"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js 与 npm/npx 环境
- 腾讯云账号,并在密钥管理中创建 SecretId / SecretKey
- 一个 COS 存储桶 (Bucket) 及其所在地域 (Region)
- 使用数据智能检索 (MetaInsight) 时需在数据集管理中创建数据集并提供 DatasetName
About 腾讯云 COS MCP Server
腾讯官方的 COS MCP Server,将腾讯云对象存储 (COS) 与数据万象 (CI) 的能力暴露为 MCP 工具,可在 Cursor、Claude 等客户端中通过自然语言完成文件上传/下载/列举、获取签名链接,以及图片超分辨率、抠图、二维码识别、质量评估、文字水印、视频智能封面、文档转 PDF、以图/以文搜图等云端处理任务。支持 stdio 与 sse 两种传输方式。
Tools & capabilities (21)
getCosConfig获取当前 COS / 腾讯云配置(SecretId、SecretKey 会脱敏显示)。
putObject上传本地文件到存储桶,可指定存储桶内的文件名与目标目录。
putString上传字符串内容到存储桶,可指定文件名、目标目录与 contentType。
putBase64上传 Base64 编码内容到存储桶,可指定文件名、目标目录与 contentType。
putBuffer上传 buffer 内容到存储桶,支持 hex/base64/utf8/ascii/binary 等编码。
putObjectSourceUrl通过 URL 下载文件并将其上传到存储桶。
getObjectUrl获取存储桶内文件的带签名下载链接。
getObject下载存储桶内的文件。
getBucket查询存储桶内的文件列表,可按路径前缀过滤。
imageInfo图片处理-获取图片信息。
assessQuality图片处理-图片质量评估。
aiSuperResolution图片处理-超分辨率。
aiPicMatting图片处理-抠图,可指定宽高。
aiQrcode图片处理-识别存储桶内二维码图片的内容。
waterMarkFont生成带文字水印的图片(支持中文)。
createMediaSmartCoverJob创建媒体智能封面(视频截帧)任务。
describeMediaJob根据 jobId 查询指定的媒体智能封面任务结果。
imageSearchPic以图搜图:根据输入图片从 MetaInsight 数据集中检索内容相似的图片。
imageSearchText以文搜图:根据输入文本从 MetaInsight 数据集中检索相符的图片。
createDocToPdfJob创建文档转 PDF 处理任务。
describeDocProcessJob根据 jobId 查询指定的文档转码任务结果。
When to use it
- 将其他 MCP 能力获取的文本/图片/视频/音频数据直接上传到 COS 云端存储。
- 本地数据通过大模型快速转存到 COS 云端存储或备份。
- 将网页里的视频/图片/音频/文本等数据批量转存到 COS。
- 在云端对图片做超分辨率、抠图、加水印或质量评估,并将结果存回 COS。
- 通过以图搜图 / 以文搜图在数据集中检索相似或相符的图片。
Security notes
需要腾讯云 SecretId / SecretKey 才能访问你的存储桶,凭据通过命令行参数(--SecretId / --SecretKey,或 --cos-config JSON)或源码安装时的 .env 文件传入;请妥善保管、切勿泄露或提交到版本库。建议使用权限最小化的子账号密钥。
腾讯云 COS MCP Server FAQ
支持哪些连接方式?
支持 stdio(本地,默认)和 sse(远程)。通过 --connectType 参数切换,sse 模式可用 --port 指定端口(默认 3001),客户端通过 url(如 http://localhost:3001/sse)连接。
如何获取所需的凭据和参数?
在腾讯云密钥管理 (console.cloud.tencent.com/cam/capi) 创建 SecretId / SecretKey;在存储桶列表创建并查看 Bucket 与 Region;如需数据智能检索,在数据集管理中创建数据集获取 DatasetName。
全局安装后命令无法直接使用怎么办?
可能是全局变量问题,可改用 npx 方式启动,或使用 --cos-config JSON 形式传参;若终端对双引号敏感,可对 JSON 中的引号进行转义。
Alternatives to 腾讯云 COS MCP Server
Compare all alternatives →Official MCP reference server for secure local filesystem read/write within allowed directories.
Official MCP server for reading, searching, and manipulating a local Git repository's files and history.
Official AWS Labs MCP server to manage and query S3 Tables (table buckets, namespaces, tables).
Compare 腾讯云 COS MCP Server with: