Sufy MCP Server

Sufy MCP サーバー

中国語ドキュメント | 英語ドキュメント

概要

Sufy 製品を基盤として構築された Model Context Protocol（MCP）サーバーを使用すると、AI LLM クライアントのコンテキスト内で、この MCP サーバーを通じて Sufy サービスにアクセスできます。

環境要件

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

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

以下は、提供されたテキストの英語訳です：

# Mac, recommended to install using brew
brew install uv


# Linux & Mac
# 1. Installation
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. After installation, make sure to add the package installation directory (the directory containing uv and uvx executables) to your system's PATH environment variable.
# Assuming the installation path is /Users/xxx/.local/bin (see installation output)
### Temporary effect (current session), execute the following command in your current terminal:
export PATH="/Users/xxx/.local/bin:$PATH"
### Permanent effect (recommended), execute the following command in your current terminal:
echo 'export PATH="/Users/xxx/.local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile


# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

具体的なインストール方法については、uv のインストールを参照してください。

Cline での使用方法

手順：

1. VSCode に Cline プラグインをインストールします（インストール後、サイドバーに Cline アイコンが表示されます）
2. LLM を設定します
3. Sufy MCP を設定します
   1. Cline アイコンをクリックしてプラグイン画面を開き、MCP サーバーモジュールを選択します
   2. 「Installed」を選択し、「Advanced MCP Settings」をクリックして、次のテンプレートを使用して設定します：

   {
     "mcpServers": {
       "Sufy": {
         "command": "uvx",
         "args": [
           "sufy-mcp-server"
         ],
         "env": {
           "SUFY_ACCESS_KEY": "YOUR_ACCESS_KEY",
           "SUFY_SECRET_KEY": "YOUR_SECRET_KEY",
           "SUFY_REGION_NAME": "YOUR_REGION_NAME",
           "SUFY_ENDPOINT_URL": "YOUR_ENDPOINT_URL",
           "SUFY_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B"
        },
         "disabled": false
       }
     }
   }
   

   3. Sufy MCP Server の接続スイッチをオンにして、接続を確立します
4. Cline でチャットウィンドウを作成し、sufy-mcp-server を使用して AI とやり取りします。プロンプトの例： ◦ Sufy のリソース情報を一覧表示する ◦ Sufy のすべての Bucket を一覧表示する ◦ Sufy の xxx Bucket にあるファイルを一覧表示する ◦ Sufy の xxx Bucket にある yyy ファイルの内容を読み取る ◦ Sufy の xxx Bucket にある yyy 画像のサイズを 20% 変更する

注：Cline で MCP サーバーを作成する際は、上記の設定をそのまま使用できます。

開発

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

git clone [email protected]:sufy/sufy-mcp-server.git
cd sufy-mcp-server

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

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

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

uv pip install -e .

4. 設定

環境変数のテンプレートをコピーします：

cp .env.example .env

.env ファイルを編集し、次のパラメーターを設定します：

# S3/Sufy credentials
SUFY_ACCESS_KEY=your_access_key
SUFY_SECRET_KEY=your_secret_key

# Region info
SUFY_REGION_NAME=your_region
SUFY_ENDPOINT_URL=endpoint_url # eg:https://s3.your_region.sufycs.com

# Configure buckets (comma-separated, max 20 recommended)
SUFY_BUCKETS=bucket1,bucket2,bucket3

機能を拡張する場合：

1. core の下に新しいビジネスパッケージのディレクトリを作成します（例：storage）
2. パッケージディレクトリ内に機能を実装します
3. パッケージの __init__.py にある load() 関数を通じて、ツール／リソースを登録します
4. core/__init__.py で load 関数を呼び出し、登録を完了します

ディレクトリ構成：

core
├── __init__.py # Load business tools/resources
└── storage # Storage service
    ├── __init__.py # Load storage tools/resources
    ├── resource.py # Storage resources
    ├── storage.py # Storage utilities
    └── tools.py # Storage tools

テスト

Model Control Protocol Inspector を使用する

推奨ツール：Model Control Protocol Inspector

# Requires node v22.4.0
npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server

ローカル MCP サーバーの例

1. stdio モードで起動します（デフォルト）：

uv --directory . run sufy-mcp-server

2. SSE モードで起動します（ウェブアプリケーション向け）：

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