Tencent Cloud COS MCP

Official

by Tencent

36 667 downloads Not rated yet

GitHub

About

Quickly integrate with Tencent Cloud Storage (COS) and Data Processing (CI) capabilities powered

Explore

- Upload, download, and list files on COS
- Image info retrieval and super-resolution
- Image cropping and quality assessment
- QR code

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Tencent Cloud COS MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install via npx or npm, then configure with your Tencent Cloud credentials (SecretId, SecretKey, Bucket, Region). Optionally set a DatasetName for data intelligence features, and choose between stdio or SSE transport mode. Add the server to your MCP client’s mcp.json configuration to start using its tools.

`getCosConfig`

获取COS配置, 腾讯云配置

`putObject`

上传本地文件到存储桶

`putString`

上传字符串内容到存储桶

`putBase64`

上传base64编码内容到存储桶

`putBuffer`

上传buffer内容到存储桶

`putObjectSourceUrl`

通过 url下载文件并将文件上传到存储桶

`getObjectUrl`

获取存储桶内的文件的带签名的下载链接

`getObject`

下载存储桶内的文件

`getBucket`

查询存储桶内的文件列表

`imageInfo`

图片处理-获取图片信息

`assessQuality`

图片处理-图片质量评估

`aiSuperResolution`

图片处理-超分辨率

`aiPicMatting`

图片处理-抠图

`aiQrcode`

图片处理-二维码识别-识别存储桶内二维码图片内容

`waterMarkFont`

生成带文字水印的图片

`createMediaSmartCoverJob`

创建媒体智能封面任务

`describeMediaJob`

根据 jobid 查询指定的媒体智能封面任务结果

`imageSearchPic`

根据输入的图片，从数据集中检索出与输入的图片内容相似的图片

`imageSearchText`

根据输入的文本内容，从数据集中检索出与输入的文本内容相符的图片

`createDocToPdfJob`

创建文档转 pdf 处理任务

`describeDocProcessJob`

根据 jobid 查询指定的文档转码任务结果

- getCosConfig: 获取COS配置, 腾讯云配置
- putObject: 上传本地文件到存储桶
- putString: 上传字符串内容到存储桶
- putBase64: 上传base64编码内容到存储桶
- putBuffer: 上传buffer内容到存储桶
- putObjectSourceUrl: 通过 url下载文件并将文件上传到存储桶
- getObjectUrl: 获取存储桶内的文件的带签名的下载链接
- getObject: 下载存储桶内的文件
- getBucket: 查询存储桶内的文件列表
- imageInfo: 图片处理-获取图片信息
- assessQuality: 图片处理-图片质量评估
- aiSuperResolution: 图片处理-超分辨率
- aiPicMatting: 图片处理-抠图
- aiQrcode: 图片处理-二维码识别-识别存储桶内二维码图片内容
- waterMarkFont: 生成带文字水印的图片
- createMediaSmartCoverJob: 创建媒体智能封面任务
- describeMediaJob: 根据 jobid 查询指定的媒体智能封面任务结果
- imageSearchPic: 根据输入的图片，从数据集中检索出与输入的图片内容相似的图片
- imageSearchText: 根据输入的文本内容，从数据集中检索出与输入的文本内容相符的图片
- createDocToPdfJob: 创建文档转 pdf 处理任务
- describeDocProcessJob: 根据 jobid 查询指定的文档转码任务结果

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

中文 | English

腾讯云 COS MCP Server 🚀🚀🚀

![](https://badge.mcpx.dev?type=server 'MCP Server')

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

---

✨ 核心功能

云端存储能力

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

云端处理能力

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

---

💡 典型应用场景

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

---

🌟 功能示例

1. 上传文件到 COS
eg1
2. 图片质量评估
eg3
3. 自然语言检索图片
eg2
4. 视频截帧
eg15

---

🔧 安装使用

参数说明

为了保护您的数据私密性，请准备以下参数：

1. SecretId / SecretKey

- 说明: 腾讯云 COS 的密钥，用于身份认证，请妥善保管，切勿泄露。 - 获取方式: 1. 访问腾讯云密钥管理。 2. 新建密钥并复制生成的 SecretId 和 SecretKey。

2. Bucket

- 示例: mybucket-123456 - 说明: 存储桶名称，用于存放数据，相当于您的个人存储空间。 - 获取方式: 1. 访问存储桶列表。 2. 复制存储桶名称。如果没有存储桶，可点击“创建存储桶”，一般选择默认配置即可快速完成创建。

3. Region

- 示例: ap-beijing - 说明: 存储桶所在的地域。 - 获取方式: 1. 在存储桶列表中找到存储桶。 2. 在存储桶名称一行查看所属地域并复制，例如：ap-beijing。

4. DatasetName

- 说明: 非必填参数，数据智能检索操作需要此参数。 - 获取方式: 1. 访问数据集管理。 2. 创建数据集并等待索引建立完成后，复制数据集名称。

5. connectType

- 说明: 非必填参数，指定连接方式，可选值为 stdio（本地）或 sse（远程）。 - 默认值: stdio

6. port

- 说明: 非必填参数，当连接方式为 sse 时，可自由设置端口。 - 默认值: 3001

---

从 npx 启动

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

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

也可以通过 JSON 配置：

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

---

使用 npm 安装

# 安装
npm install -g cos-mcp@latest
运行开启 SSE 模式
cos-mcp --Region=yourRegion --Bucket=yourBucket --SecretId=yourSecretId --SecretKey=yourSecretKey --DatasetName=yourDatasetname --port=3001 --connectType=sse
或通过 JSON 配置
cos-mcp --cos-config='{"Region":"yourRegion","Bucket":"BucketName-APPID","SecretId":"yourSecretId","SecretKey":"yourSecretKey","DatasetName":"datasetName"}' --port=3001 --connectType=sse

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

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

---

使用源码安装

步骤 1: 克隆项目代码

git clone https://github.com/Tencent/cos-mcp.git
cd cos-mcp

步骤 2: 安装依赖

npm install

步骤 3: 启动服务

3.1 配置本地环境变量

创建 .env 文件，并配置以下环境变量：

Region='yourRegion'
Bucket='yourBucket'
SecretId='yourSecretId'
SecretKey='yourSecretKey'
DatasetName="yourDatasetName"

3.2 本地 SSE 模式启动（方式一）

npm run start:sse

3.3 本地构建后使用 STDIO 模式（方式二）

npm run build

构建产物位于 dist/index.js。

---

步骤 4: 在大模型内使用

SSE 模式配置

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

STDIO 模式配置

{
  "mcpServers": {
    "cos-mcp": {
      "command": "node",
      "args": [
        "${your work space}/dist/index.js"
      ]
    }
  }
}

完成以上步骤后，即可通过源码运行 COS MCP Server。

---

⚠️ 注意事项

1. 如果安装了旧版本的包，可以将上述内容内 cos-mcp 改为 cos-mcp@latest 安装最新版包。
2. 如果全局安装后直接使用 cos-mcp 不行，可能是全局变量有问题，可以使用拆分变量或 npx 的方式启动：

   npm install -g cos-mcp@latest

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

上述命令效果等同于：

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

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

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

getCosConfig

putObject

putString

putBase64

putBuffer

putObjectSourceUrl

getObjectUrl

getObject

getBucket

imageInfo

assessQuality

aiSuperResolution

aiPicMatting

aiQrcode

waterMarkFont

createMediaSmartCoverJob

describeMediaJob

imageSearchPic

imageSearchText

createDocToPdfJob

describeDocProcessJob

Claude Desktop / Cursor

McpServers

腾讯云 COS MCP Server 🚀🚀🚀

✨ 核心功能

云端存储能力

云端处理能力

💡 典型应用场景

🌟 功能示例

🔧 安装使用

参数说明

1. SecretId / SecretKey

2. Bucket

3. Region

4. DatasetName

5. connectType

6. port

从 npx 启动

使用 npm 安装

运行开启 SSE 模式

或通过 JSON 配置

使用源码安装

步骤 1: 克隆项目代码

步骤 2: 安装依赖

步骤 3: 启动服务

3.1 配置本地环境变量

3.2 本地 SSE 模式启动（方式一）

3.3 本地构建后使用 STDIO 模式（方式二）

步骤 4: 在大模型内使用

SSE 模式配置

STDIO 模式配置

⚠️ 注意事项

More like this

Sequential Thinking

Sentry

Github

Filesystem

`getCosConfig`

`putObject`

`putString`

`putBase64`

`putBuffer`

`putObjectSourceUrl`

`getObjectUrl`

`getObject`

`getBucket`

`imageInfo`

`assessQuality`

`aiSuperResolution`

`aiPicMatting`

`aiQrcode`

`waterMarkFont`

`createMediaSmartCoverJob`

`describeMediaJob`

`imageSearchPic`

`imageSearchText`

`createDocToPdfJob`

`describeDocProcessJob`