Wcs MCP Server

🚀 网宿 MCP サーバー

このサーバーは、网宿クラウド製品をベースに構築されたモデルコンテキストプロトコル（Model Context Protocol、略称 MCP）サーバーです。AI 大規模モデルクライアントのコンテキスト内で、この MCP サーバーを通じて网宿クラウドストレージやスマートマルチメディアサービスなどにアクセスできます。

🚀 クイックスタート

このセクションでは、网宿 MCP サーバーのインストール、設定、使用方法について説明します。

✨ 主な機能

• AI 大規模モデルクライアントのコンテキスト内で、网宿クラウドストレージやスマートマルチメディアサービスなどにアクセスできます。
• 標準入出力（stdio）モードと SSE モードをサポートしています。

📦 インストール

前提条件

• Python 3.12 以上
• uv パッケージマネージャー

uv がインストールされていない場合は、以下のコマンドを使用してインストールできます。

curl -LsSf https://astral.sh/uv/install.sh | sh

インストール手順

1. リポジトリをクローンします。

# プロジェクトをクローンし、ディレクトリに移動します
git clone git@github.com:Wangsu-Cloud-Storage/wcs-mcp-server.git
cd wcs-mcp-server

2. 仮想環境を作成し、アクティブ化します。

uv venv
source .venv/bin/activate  # Linux/macOS システムで
# または Windows システムで
.venv\Scripts\activate

3. 依存関係をインストールします。

uv pip install -e .

📚 ドキュメント

設定

1. 環境変数のテンプレートファイルをコピーします。

cp .env.example .env

2. .env ファイルを編集し、以下のパラメータを設定します。

# S3/Kodo 認証情報
WOS_ACCESS_KEY=your_access_key  # あなたのアクセスキーに置き換えてください
WOS_SECRET_KEY=your_secret_key  # あなたのシークレットキーに置き換えてください

# リージョン情報
WOS_REGION_NAME=your_region      # あなたがいるリージョン名に置き換えてください
WOS_ENDPOINT_URL=endpoint_url    # 例：https://s3.your_region.woscs.com

# バケットを設定します。複数のバケットはカンマで区切り、最大 20 個のバケットを設定することをお勧めします。
WOS_BUCKETS=bucket1,bucket2,bucket3  # 設定するバケット名に置き換えてください

使用方法

サーバーの起動

1. 標準入出力（stdio）モードで起動します（デフォルトモード）。

uv --directory . run wos-mcp-server

2. SSE モードで起動します（ストリーミングメディアシナリオに適しています）。

uv --directory . run --transport sse wos-mcp-server

開発

1. プロジェクトのディレクトリ構造は次のとおりです。

wos-mcp-server/
├── src/
│   ├── main.py         # メインプログラムのエントリーポイント
│   └── resources/      # リソースファイルのディレクトリ
└── uv_lock.yaml        # uv パッケージマネージャーの依存関係ロックファイル

2. 機能拡張

• 新しいリソースタイプを追加するには、src/resources ディレクトリに新しいリソースモジュールを作成し、main.py でそのリソースを登録します。
• 既存の機能を変更するには、必要に応じて既存のコードを調整し、网宿クラウドサービスプロトコルと互換性があることを確認します。

テスト

1. Inspector ツールを使用して MCP サーバーの機能をテストします。
   • すべてのリソース情報を列挙します。
   • すべての利用可能なバケットを列挙します。
   • 指定されたバケット内のすべてのファイルを列挙します。
   • 指定されたバケット内の特定のファイルの内容を読み取ります。
2. Cline プラグインを使用してテストします。
   • Cline で新しいチャットウィンドウを作成します。
   • wos MCP Server に接続します。
   • 以下のコマンドを送信します。
     • すべてのリソース情報をリストします。
     • すべての利用可能なバケットをリストします。
     • 指定されたバケット内のすべてのファイルをリストします。
     • 指定されたバケット内の特定のファイルの内容を読み取ります。

以上の手順に従うことで、网宿 MCP サーバーのインストール、設定、使用をスムーズに完了することができます。