腾讯云 COS MCP服务器

seostar/tx-cos-mcp

1 Stars 540 次浏览 seo 更新于 2026-08-23

一个基于 Node.js 的 Model Context Protocol (MCP) 服务器，为 Claude Desktop、Cursor 和 Windsurf 等 IDE 提供腾讯云对象存储(COS)功能。支持文件上传、临时URL生成、文件管理和文件删除。

开发者工具文件系统

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "tx-cos-mcp": {
      "args": [
        "y",
        "tx-cos-mcp@latest"
      ],
      "command": "npx",
      "env": {
        "COS_BUCKET": "your-bucket",
        "COS_DOMAIN": "your-custom-domain.com",
        "COS_REGION": "your-region",
        "COS_SECRET_ID": "your-secret-id",
        "COS_SECRET_KEY": "your-secret-key"
      },
      "transportType": "stdio"
    }
  }
}

该服务需要配置环境变量：COS_BUCKET、COS_DOMAIN、COS_REGION、COS_SECRET_ID、COS_SECRET_KEY

服务介绍

腾讯云 COS MCP 服务器

一个Model Context Protocol (MCP)服务器，为 Claude Desktop、Cursor 和 Windsurf 等 IDE 提供腾讯云对象存储(COS)功能。

功能特性

🚀 文件上传 - 支持单文件和批量文件上传到腾讯云 COS
📦 大文件上传 - 自动分片上传，支持断点续传和进度监控
🔄 并发控制 - 智能重试机制和可配置并发限制
🧹 资源清理 - 自动清理临时文件，防止磁盘空间泄漏
📁 文件管理 - 复制、移动、重命名文件操作
🗂️ 文件夹操作 - 创建、删除文件夹，支持递归操作
🔗 临时 URL - 生成带签名的临时访问链接，支持自定义过期时间
📋 对象管理 - 列出存储桶中的对象，支持前缀过滤和文件夹视图
🗑️ 批量删除 - 支持单个和批量删除 COS 中的对象
📊 统计分析 - 文件夹统计信息，包括大小、数量、类型分布
🔧 MCP 兼容 - 完全兼容 Model Context Protocol 规范

环境变量说明

变量名	必需	说明	示例
`COS_SECRET_ID`	✅	腾讯云 Secret ID	`AKIDxxx...`
`COS_SECRET_KEY`	✅	腾讯云 Secret Key	`xxx...`
`COS_REGION`	✅	COS 地域	`ap-beijing`, `ap-shanghai`
`COS_BUCKET`	✅	存储桶名称	`my-bucket-1234567890`
`COS_DOMAIN`	❌	自定义域名	`cdn.example.com`

MCP 工具列表

工具名称	功能	必需参数	可选参数
`upload_file`	单文件上传	`file_path`	`object_key`, `custom_domain`
`upload_multiple`	批量上传	`files[]`	`concurrency`, `max_retries`
`upload_large_file`	大文件分片上传	`file_path`	`object_key`, `custom_domain`, `chunk_size`, `concurrency`, `force_slice`
`get_upload_progress`	获取上传进度	-	`session_id`
`clear_upload_progress`	清理上传进度	`session_id`	-
`manage_temp_files`	管理临时文件	`action`	`type`, `older_than_days`
`copy_object`	复制对象	`source_key`, `target_key`	`target_bucket`
`move_object`	移动对象	`source_key`, `target_key`	`target_bucket`
`rename_object`	重命名对象	`old_key`, `new_key`	-
`delete_object`	删除对象	`object_key`	-
`delete_multiple`	批量删除	`object_keys[]`	-
`create_folder`	创建文件夹	`folder_path`	-
`delete_folder`	删除文件夹	`folder_path`	`recursive`
`list_objects`	列出对象	-	`prefix`
`list_folders`	列出文件夹	-	`prefix`
`get_folder_stats`	文件夹统计	-	`folder_path`
`get_signed_url`	临时URL	`object_key`	`expire_time`

集成配置

{
  "mcpServers": {
    "tx-cos-mcp": {
      "command": "npx",
      "args": ["y", "tx-cos-mcp@latest"],
      "env": {
        "COS_SECRET_ID": "your-secret-id",
        "COS_SECRET_KEY": "your-secret-key",
        "COS_REGION": "your-region",
        "COS_BUCKET": "your-bucket",
        "COS_DOMAIN": "your-custom-domain.com"
      },
      "transportType": "stdio"
    }
  }
}

实用提示词示例

文件上传相关：

请帮我上传这个文件到COS：/path/to/myfile.jpg
批量上传这几个文件到examples文件夹：file1.txt, file2.pdf, file3.png
上传文件并指定对象键名为photos/2024/avatar.jpg

文件访问相关：

获取文件document.pdf的临时下载链接，有效期1小时
为图片image.jpg生成30分钟有效的分享链接

文件管理相关：

列出COS中所有在uploads/文件夹下的文件
删除旧版本的backup/data.json文件
查看当前COS存储桶中有哪些文件

实际业务场景：

上传项目构建后的dist文件夹内容到static目录
为用户头像生成临时访问链接用于前端显示
清理test/目录下的所有测试文件
统计一下cos用量

支持与反馈

🐛 问题反馈: GitHub Issues
💡 功能建议: GitHub Discussions
📧 联系作者: 156554395@qq.com

查看源码项目主页