Tencent Cloud COS MCP Server

🚀 COS - MCP 服务

通过此 README 文件，你可以了解如何安装和使用 COS - MCP 服务。该服务能帮助你更便捷地实现相关功能，提升整体效率。

🚀 快速开始

通过此 README 文件了解如何安装和使用 COS - MCP 服务。

📦 安装指南

方法一：使用 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

方法二：使用源码安装

步骤 1: 克隆项目代码

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

步骤 2: 安装依赖

npm install

步骤 3: 启动服务

方式一：启动本地 SSE 模式

npm run start:sse

方式二：构建后使用 STDIO 模式

npm run build

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

📚 详细文档

配置说明

环境变量配置

创建 .env 文件，并添加以下内容：

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

在大模型中使用

SSE 模式配置

在 mcp.json 中添加：

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

STDIO 模式配置

在 mcp.json 中添加：

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

📄 许可证

⚠️ 重要提示

1. 安装时请使用最新版本的包，将 cos-mcp 替换为 cos-mcp@latest。
2. 如全局安装后无法直接运行 cos-mcp，建议使用 npx：

   npm install -g cos-mcp@latest
   npx cos-mcp --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