项目介绍

这是一个用于与腾讯云COS（Cloud Object Storage）交互的MCP（Message Communication Protocol）服务器。该服务器允许通过命令行或配置文件的方式连接到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

配置说明

命令行参数

• --Region：腾讯云COS的地域，例如ap-guangzhou。
• --Bucket：要操作的COS桶名称。
• --SecretId：腾讯云API密钥ID。
• --SecretKey：腾讯云API密钥KEY。
• --DatasetName：可选，指定数据集名称。
• --port：可选，默认3001，指定服务监听的端口。
• --connectType：可选，默认stdio，指定连接类型（stdio或sse）。

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文件。