Tencent Cloud Object Storage

🚀 用於與騰訊雲COS交互的MCP服務器

這是一個用於與騰訊雲COS（Cloud Object Storage）交互的MCP（Message Communication Protocol）服務器。該服務器允許通過命令行或配置文件的方式連接到COS，並提供文件上傳、下載、列舉目錄等功能。

🚀 快速開始

此MCP服務器可幫助你輕鬆與騰訊雲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"
    }
  }
}

📄 許可證

該軟件遵循MIT許可證，詳細內容請查看LICENSE文件。

⚠️ 重要提示

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