一个基于 Node.js 的 Model Context Protocol (MCP)服务器，为 Claude Desktop、Cursor 和 Windsurf 等 IDE 提供腾讯云对象存储(COS)功能。
📖 快速上手: 查看 快速参考指南 了解所有工具的基本用法
📚 详细文档: 查看 工具使用说明 获取完整的API文档和示例
# 克隆项目
git clone https://github.com/156554395/tx-cos-mcp.git
cd tx-cos-mcp
# 安装依赖
pnpm install
# 配置环境变量
export COS_SECRET_ID=your-secret-id
export COS_SECRET_KEY=your-secret-key
export COS_REGION=your-region
export COS_BUCKET=your-bucket
export COS_DOMAIN=your-custom-domain.com
# 启动调试服务器
pnpm inspector
服务器通过环境变量读取腾讯云 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_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 |
{
"file_path": "/path/to/local/file.jpg", // 必需：本地文件路径
"object_key": "images/file.jpg", // 可选：COS中的对象键
"custom_domain": "cdn.example.com" // 可选：自定义域名
}
{
"files": [
{
"file_path": "/path/to/file1.jpg",
"object_key": "images/file1.jpg" // 可选
},
{
"file_path": "/path/to/file2.png" // 使用文件名作为对象键
}
]
}
{
"object_key": "images/file.jpg", // 必需：COS对象键
"expire_time": 3600 // 可选：过期时间(秒)，默认1小时
}
{
"prefix": "images/" // 可选：对象键前缀过滤
}
{
"object_key": "images/file.jpg" // 必需：要删除的对象键
}
{
"source_key": "images/file.jpg", // 必需：源对象键
"target_key": "backup/file.jpg", // 必需：目标对象键
"target_bucket": "other-bucket" // 可选：目标存储桶
}
{
"source_key": "temp/file.jpg", // 必需：源对象键
"target_key": "images/file.jpg", // 必需：目标对象键
"target_bucket": "other-bucket" // 可选：目标存储桶
}
{
"old_key": "images/old_name.jpg", // 必需：原对象键
"new_key": "images/new_name.jpg" // 必需：新对象键
}
{
"object_keys": [ // 必需：对象键数组
"images/file1.jpg",
"images/file2.jpg",
"temp/file3.png"
]
}
{
"folder_path": "images/thumbnails" // 必需：文件夹路径
}
{
"folder_path": "temp/", // 必需：文件夹路径
"recursive": true // 可选：是否递归删除，默认false
}
{
"prefix": "images/" // 可选：路径前缀，默认根目录
}
{
"folder_path": "images/" // 可选：文件夹路径，为空则统计整个存储桶
}
{
"file_path": "/path/to/large/video.mp4", // 必需：本地大文件路径
"object_key": "videos/video.mp4", // 可选：COS中的对象键
"custom_domain": "cdn.example.com", // 可选：自定义域名
"chunk_size": 2097152, // 可选：分片大小(字节)，默认1MB
"concurrency": 5, // 可选：并发上传数，默认3，最大10
"force_slice": true // 可选：强制使用分片上传
}
{
"session_id": "abc123def456" // 可选：特定会话ID，不提供则返回所有
}
{
"session_id": "abc123def456" // 必需：要清理的会话ID
}
{
"action": "cleanup", // 必需：'stats'(统计) 或 'cleanup'(清理)
"type": "progress", // 可选：'progress'/'cache'/'uploads'/'all'
"older_than_days": 7 // 可选：清理多少天前的文件，默认7天
}
{
"mcpServers": {
"tx-cos-mcp": {
"command": "node",
"args": ["your-absolute-path/tx-cos-mcp/index.js"],
"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"
}
}
}
}
{
"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"
}
}
}
在配置中添加 MCP 服务器配置，使用相同的 JSON 格式。
在设置中添加 MCP 服务器配置，使用相同的 JSON 格式。
参考官方文档配置 MCP 服务器，使用上述配置参数。
# 查看版本
npx tx-cos-mcp --version
# 测试配置
COS_SECRET_ID=xxx COS_SECRET_KEY=xxx COS_REGION=your-region COS_BUCKET=test npx tx-cos-mcp
# 开发模式
npm run dev
# 运行测试
npm run test # 基础功能测试
npm run test:mcp # MCP协议合规性测试
npm run test:temp # 临时目录管理测试
npm run test:cleanup # 临时文件清理测试
npm run test:path # 文件路径验证测试
# 发布到npm (维护者)
npm run publish:npm
项目包含完整的测试套件，确保功能的可靠性：
test/test.js - 基础功能测试test/test-mcp.js - MCP协议合规性测试test/test-temp.js - 临时目录管理测试test/test-cleanup.js - 临时文件清理测试test/test-path-validation.js - 文件路径验证测试# 运行所有测试
npm test
# 单独测试
npm run test:mcp # 测试MCP协议功能
npm run test:temp # 测试临时目录管理
npm run test:cleanup # 测试临时文件清理
npm run test:path # 测试文件路径验证
tx-cos-mcp/
├── index.js # MCP服务器主入口
├── src/
│ ├── cosService.js # COS SDK封装服务
│ ├── config.js # 配置管理
│ ├── uploadProgress.js # 上传进度管理
│ └── tempManager.js # 临时文件管理
├── test/ # 测试文件目录
│ ├── test.js # 基础功能测试
│ ├── test-mcp.js # MCP协议合规性测试
│ ├── test-temp.js # 临时目录管理测试
│ └── test-cleanup.js # 临时文件清理测试
├── config-examples/ # 配置示例
├── package.json # 项目配置
└── README.md # 项目文档
@modelcontextprotocol/sdk - MCP 协议实现cos-nodejs-sdk-v5 - 腾讯云 COS 官方 SDKgit checkout -b feature/new-feature)git commit -am 'Add new feature')git push origin feature/new-feature)MIT License - 查看LICENSE文件了解详情。
FAQs
腾讯云COS MCP服务器 - 基于Node.js的Model Context Protocol服务器，提供腾讯云对象存储服务功能
The npm package tx-cos-mcp receives a total of 3 weekly downloads. As such, tx-cos-mcp popularity was classified as not popular.
We found that tx-cos-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
Security News
NIST will stop enriching most CVEs under a new risk-based model, narrowing the NVD's scope as vulnerability submissions continue to surge.
Company News
/Security News
Socket is an initial recipient of OpenAI's Cybersecurity Grant Program, which commits $10M in API credits to defenders securing open source software.