Tencent Cloud Object Storage

🚀 COS-MCPサーバー

このサーバーは、腾讯云COS（Cloud Object Storage）とのインタラクションを行うためのMCP（Message Communication Protocol）サーバーです。コマンドラインまたは設定ファイルを使用してCOSに接続し、ファイルのアップロード、ダウンロード、ディレクトリの列挙などの機能を提供します。

🚀 クイックスタート

このサーバーは、腾讯云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"
    }
  }
}

💻 使用例

基本的な使用法

大規模モデルで使用する場合、mcp.jsonファイルにCOS MCP ServerのURLを設定する必要があります。例えば：

{
  "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ファイルを参照してください。