Tencent Cloud COS MCP Server

公式

Tencent Cloud COS（Cloud Object Storage）およびデータ処理（CI）機能を活用した迅速な統合を実現します。

GitHub
36

ドキュメント

日本語 | English

Tencent Cloud COS MCP Server 🚀🚀🚀

npm Version license

logo

MCPプロトコルに基づくTencent Cloud COS MCP Serverは、コーディング不要で大規模モデルをTencent Cloud Storage (COS) およびデータ万象 (CI) の機能に迅速に接続します。

✨ コア機能

クラウドストレージ機能

  • ⬆️ ファイルをクラウドにアップロード
  • ⬇️ クラウドからファイルをダウンロード
  • 📋 クラウドファイル一覧の取得

クラウド処理機能

  • 🖼️ 画像情報の取得
  • 🔍 画像の超解像
  • ✂️ 画像の切り抜き
  • 📲 QRコード認識
  • 🏆 画質評価
  • 🅰️ テキスト透かし
  • 🎬 メタデータ/自然言語検索 (MateInsight)
  • 📄 ドキュメントからPDFへの変換
  • 🎥 動画サムネイル

💡 代表的なユースケース

  • 他のMCP機能で取得したテキスト/画像/動画/音声などのデータを、直接COSクラウドストレージにアップロードできます。
  • ローカルデータを大規模モデル経由で迅速にCOSクラウドストレージへ転送/バックアップできます。
  • 大規模モデルによる自動化：Webページ内の動画/画像/音声/テキストなどのデータを一括でCOSクラウドストレージに転送します。
  • 動画/画像/音声/テキストなどのデータをクラウド上で自動処理し、COSクラウドストレージに転送します。

🌟 機能例

  1. COSへのファイルアップロード
    eg1
  2. 画質評価
    eg3
  3. 自然言語による画像検索
    eg2
  4. 動画フレームキャプチャ
    eg15

🔧 インストールと使用方法

パラメータの説明

データのプライバシーを保護するため、以下のパラメータを準備してください：

1. SecretId / SecretKey

  • 説明: Tencent Cloud COSの認証キーです。認証に使用されます。大切に保管し、絶対に漏洩させないでください。
  • 取得方法:
    1. Tencent Cloudキー管理にアクセスします。
    2. 新しいキーを作成し、生成されたSecretIdとSecretKeyをコピーします。

2. Bucket

  • 例: mybucket-123456
  • 説明: ストレージバケット名です。データの保存に使用され、個人用のストレージスペースに相当します。
  • 取得方法:
    1. バケットリストにアクセスします。
    2. バケット名をコピーします。バケットがない場合は、「バケットの作成」をクリックし、通常はデフォルト設定で迅速に作成できます。

3. Region

  • 例: ap-beijing
  • 説明: バケットが存在するリージョンです。
  • 取得方法:
    1. バケットリストでバケットを見つけます。
    2. バケット名の行で所属リージョンを確認し、コピーします（例：ap-beijing）。

4. DatasetName

  • 説明: オプションのパラメータです。データのインテリジェント検索操作に必要です。
  • 取得方法:
    1. データセット管理にアクセスします。
    2. データセットを作成し、インデックス構築が完了するのを待ってから、データセット名をコピーします。

5. connectType

  • 説明: オプションのパラメータです。接続方式を指定します。選択肢は stdio（ローカル）または sse（リモート）です。
  • デフォルト値: stdio

6. port

  • 説明: オプションのパラメータです。接続方式が sse の場合、ポートを自由に設定できます。
  • デフォルト値: 3001

npxからの起動

大規模モデル内で使用する場合（例：cursor）、mcp.json で設定する必要があります：

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--Region=yourRegion",
        "--Bucket=yourBucket",
        "--SecretId=yourSecretId",
        "--SecretKey=yourSecretKey",
        "--DatasetName=yourDatasetname"
      ]
    }
  }
}

JSONによる設定も可能です：

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"yourBucket\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"yourDatasetname\"}'"
      ]
    }
  }
}

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

大規模モデル内でSSEモードを使用する場合（例：cursor）、mcp.json で設定する必要があります：

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

ソースコードからのインストール

ステップ1: プロジェクトコードのクローン

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

ステップ2: 依存関係のインストール

npm install

ステップ3: サービスの起動

3.1 ローカル環境変数の設定

.env ファイルを作成し、以下の環境変数を設定します：

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

3.2 ローカルSSEモードでの起動（方法1）

npm run start:sse

3.3 ローカルビルド後のSTDIOモードでの使用（方法2）

npm run build

ビルド成果物は dist/index.js にあります。

ステップ4: 大規模モデル内での使用

SSEモードの設定

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

STDIOモードの設定

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

以上の手順を完了すると、ソースコードからCOS MCP Serverを実行できます。

⚠️ 注意事項

  1. 古いバージョンのパッケージがインストールされている場合、上記の内容の cos-mcp を cos-mcp@latest に変更して最新バージョンをインストールしてください。
  2. グローバルインストール後に cos-mcp を直接使用できない場合、グローバル変数に問題がある可能性があります。変数を分割するか、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