Tencent Cloud COS MCP Server

🚀 COS-MCP 服務

通過此 README 文件，你可以瞭解如何安裝和使用 COS-MCP 服務，該服務能為你提供特定的功能支持，幫助你更高效地完成相關任務。

🚀 快速開始

通過此 README 文件瞭解如何安裝和使用 COS-MCP 服務。

✨ 主要特性

• 支持多種安裝方式，如使用 npm 安裝和源碼安裝。
• 提供不同的啟動模式，包括 SSE 模式和 STDIO 模式。
• 可通過環境變量和 JSON 文件進行靈活配置。

📦 安裝指南

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

📄 許可證

⚠️ 重要提示

• 安裝時請使用最新版本的包，將 cos-mcp 替換為 cos-mcp@latest。
• 如全局安裝後無法直接運行 cos-mcp，建議使用 npx：

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

• 若出現解析問題，請嘗試將配置參數調整為：

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