🚀 腾讯云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
📚 详细文档
配置说明
命令行参数
| 参数 | 详情 |
|---|---|
--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"
}
}
}
注意事项
⚠️ 重要提示
- 如果安装了旧版本的包，可以将上述内容中的
cos-mcp改为cos-mcp@latest以安装最新版本。- 如果全局安装后直接使用命令无效，可以尝试使用拆分变量或
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
- 如果出现解析问题，可能是终端对双引号敏感，可以将配置参数改为以下格式再尝试：
--cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"BucketName-APPID\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"datasetName\"}' --port=3001 --connectType=sse
📄 许可证
该软件遵循MIT许可证，详细内容请查看LICENSE文件。