wos MCP Server

wos MCP サーバー

言語 / Language

• 簡体中文
• English

概要

wcs クラウド製品を基盤として構築された Model Context Protocol（MCP）サーバーです。ユーザーはこの MCP サーバーを通じて、AI LLM クライアントのコンテキストから wcs クラウドストレージやスマートマルチメディアサービスなどにアクセスできます。

インストール

前提条件

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

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

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

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

# 克隆项目并进入目录
git clone [email protected]:Wangsu-Cloud-Storage/wcs-mcp-server.git
cd wcs-mcp-server

2. 仮想環境を作成して有効化します。

uv venv
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate  # Windows

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 # eg:https://s3.your_region.woscs.com

# 配置 bucket，多个 bucket 使用逗号隔开，建议最多配置 20 个 bucket
WOS_BUCKETS=bucket1,bucket2,bucket3

使用方法

サーバーの起動

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

uv --directory . run wos-mcp-server

2. SSE モードで起動します（Web アプリケーション用）。

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

開発

機能を拡張するには、まず core ディレクトリの下に業務パッケージのディレクトリ（例：ストレージ → storage）を新しく作成し、その業務パッケージディレクトリで機能を拡張します。 業務パッケージディレクトリの __init__.py ファイルで、業務ツールまたはリソースを登録するための load 関数を定義します。最後に core ディレクトリの __init__.py でこの load 関数を呼び出し、ツールまたはリソースを登録します。

core
├── __init__.py # 各个业务工具或者资源加载
└── storage # 存储业务目录
    ├── __init__.py # 加载存储工具或者资源
    ├── resource.py # 存储资源扩展
    ├── storage.py # 存储工具类
    └── tools.py # 存储工具扩展

テスト

Model Control Protocol Inspector を使用したテスト

テストには Model Control Protocol Inspector の使用を強くおすすめします。

# node 版本为：v22.4.0
npx @modelcontextprotocol/inspector uv --directory . run wos-mcp-server

cline を使用したテスト：

手順：

1. vscode で Cline プラグインをダウンロードします（ダウンロード後、サイドバーに Cline のアイコンが追加されます）。
2. LLM を設定します。
3. wos MCP を設定します。
   1. Cline アイコンをクリックして Cline プラグインを開き、MCP Server モジュールを選択します。
   2. installed を選択し、Advanced MCP Settings をクリックして MCP Server を設定します。以下の設定情報を参照してください。

   {
     "mcpServers": {
       "wos": {
         "command": "uv",
         "args": [
           "--directory",
           "Workspace/App/wos-mcp", # 此处选择项目存储的绝对路径
           "run",
           "wos-mcp-server"
         ],
         "env": { # 此处以环境变量方式填写你的 wos mcp server 的配置信息，如果是从插件市场下载，可以通过此方式配置，如果是从本地源码安装，也可以通过上述方式在 .env 文件中配置
           "WOS_ACCESS_KEY": "YOUR_ACCESS_KEY",
           "WOS_SECRET_KEY": "YOUR_SECRET_KEY",
           "WOS_REGION_NAME": "YOUR_REGION_NAME",
           "WOS_ENDPOINT_URL": "YOUR_ENDPOINT_URL",
           "WOS_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B"
        },
         "disabled": false
       }
     }
   }
   

   3. wos MCP Server のリンクスイッチをクリックして接続します。
4. Cline でチャットウィンドウを作成すると、AI とやり取りして wos-mcp-server を使用できます。以下にいくつかの例を示します。
   • wos のリソース情報を一覧表示する
   • wos のすべての Bucket を一覧表示する
   • wos の xxx Bucket にあるファイルを一覧表示する
   • wos の xxx Bucket にある yyy のファイル内容を読み取る