Tencent Cloud Object Storage

🚀 腾讯云COS MCP服务器项目

这是一个用于与腾讯云COS（Cloud Object Storage）交互的MCP（Message Communication Protocol）服务器。借助该服务器，你可以通过命令行或配置文件的方式连接到COS，实现文件上传、下载、列举目录等功能。

🚀 快速开始

本项目是用于与腾讯云COS交互的MCP服务器，支持通过命令行或配置文件连接到COS，实现文件上传、下载及目录列举等功能。

✨ 主要特性

• 支持通过命令行或配置文件连接腾讯云COS。
• 提供文件上传、下载、列举目录等功能。

📦 安装指南

使用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

使用源码安装

# 克隆项目代码
git clone https://github.com/Tencent/cos-mcp.git
cd cos-mcp

# 安装依赖
npm install

# 启动服务
## 配置本地环境变量（创建.env文件）
Region='yourRegion'
Bucket='yourBucket'
SecretId='yourSecretId'
SecretKey='yourSecretKey'
DatasetName="yourDatasetName"

## 本地 SSE 模式启动
npm run start:sse

## 本地构建后使用 STDIO 模式
npm run build

📚 详细文档

配置说明

命令行参数

JSON配置

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

使用说明

在大模型中使用时，需要将COS MCP Server的URL配置到mcp.json文件中。例如：

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

注意事项

⚠️ 重要提示

1. 如果安装了旧版本的包，可以将上述内容中的cos-mcp改为cos-mcp@latest以安装最新版本。
2. 如果全局安装后直接使用命令无效，可以尝试使用拆分变量或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

📄 许可证

该软件遵循MIT许可证，详细内容请查看LICENSE文件。