cos-mcp

腾讯云COS MCP Server 🚀🚀🚀

基于MCP协议的腾讯云COS MCP Server，无需编码即可让大模型快速接入腾讯云存储(COS)和数据万象(CI)能力

✨ 核心功能

云端存储能力

• ⬆️ 文件上传到云端
• ⬇️ 文件从云端下载
• 📋 获取云端文件列表

云端处理能力

• 🖼️ 获取图片信息
• 🔍 图片超分辨率
• ✂️ 图片裁剪
• 📲 二维码识别
• 🏆 图片质量评估
• 🅰️ 文字水印
• 🎬 元数据/自然语言检索(MateInsight)
• 📄 文档转PDF
• 🎥 视频封面

💡 典型应用场景

• 使用其他MCP能力获取的文本/图片/视频/音频等数据，可以直接上传到COS云端存储
• 本地数据快速通过大模型转存到COS云端存储/备份
• 通过大模型实现自动化：将网页里的视频/图片/音频/文本等数据批量转存到COS云端存储
• 自动化将视频/图片/音频/文本等数据在云端处理，并转存到COS云端存储

🌟 功能示例

1. 上传文件到COS

2. 图片质量评估

3. 自然语言检索图片

4. 视频截帧

🔧 安装使用

从npx启动

在大模型内使用时（例如: cursor）, 需要在mcp.json 中配置

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"yourBucket\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"yourDatasetname\"}'",
        "--port=9000",
        "--connectType=stdio"
      ]
    }
  }
}

也可以简单配置

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--Region=yourRegion",
        "--Bucket=yourBucket",
        "--SecretId=yourSecretId",
        "--SecretKey=yourSecretKey",
        "--DatasetName=yourDatasetname",
      ]
    }
  }
}

使用npm安装

// 安装
npm install -g cos-mcp

// 运行开启sse模式
cos-mcp --cos-config='{"Region":"yourRegion","Bucket":"BucketName-APPID","SecretId":"yourSecretId","SecretKey":"yourSecretKey","DatasetName":"datasetName"}' --port=3001 --connectType=sse
// 也可以简单配置
cos-mcp  --Region=yourRegion --Bucket=yourBucket --SecretId=yourSecretId --SecretKey=yourSecretKey --DatasetName=yourDatasetname --port=3001 --connectType=sse


// 参数说明： 
// connectType 代表连接方式，可以是stdio （本地） 或 sse （远程）
// port 代表监听端口(sse模式有用)
// SecretId 和 SecretKey 可以从腾讯云COS https://console.cloud.tencent.com/cam/capi 获取
// bucket 是存储的桶名称
// region 是存储桶所在的区域

在大模型内使用sse模式时（例如: cursor）, 需要在mcp.json 中配置

{
  "mcpServers": {
    "cos-mcp": {
      "url": "http://localhost:3001/sse",
    }
  }
}

添加以上配置即可快速使大模型拥有COS/CI能力！

---

⚠️请注意！

1. 如果全局安装后直接使用cos-mcp不行，可能是全局变量有问题，可以使用拆分变量或使用 npx的方式来启动

npm install -g cos-mcp
cos-mcp --cos-config=xxx  --port=3001 --connectType=sse

上述命令效果等同于

npx cos-mcp --cos-config=xxx --port=3001 --connectType=sse

2. 如果出现解析问题 可能是终端对于双引号敏感， 可以将配置参数改为以下再尝试

--cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"BucketName-APPID\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"datasetName\"}' --port=3001 --connectType=sse