Sufy MCP Server

🚀 Sufy MCP サーバー

このサーバーは、Sufy 製品の Model Context Protocol (MCP) を基に構築されており、AI 大規模モデルクライアントからのコンテキストを通じて、ユーザーが Sufy サービスにアクセスできるようにします。

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

🚀 クイックスタート

環境要件

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

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

# Mac，brew を使用することをおすすめ
brew install uv

# Linux & Mac
# 1. インストール
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. インストールが完了したら、パッケージのインストールディレクトリ（uv と uvx 実行ファイルが含まれるディレクトリ）をシステムの PATH 環境変数に追加してください。
# 例えば、コンピューターのインストールパスが /Users/xxx/.local/bin の場合（インストール出力を参照）
### 一時的な設定（現在のセッションのみ）、現在のターミナルで以下のコマンドを実行：
export PATH="/Users/xxx/.local/bin:$PATH"
### 永続的な設定（推奨）、現在のターミナルで以下のコマンドを実行：
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 インストールを参照してください。

コマンドラインインターフェイスでの使用

手順：

1. VSCode で Cline プラグインをインストールします（インストールが完了すると、サイドバーに Cline アイコンが表示されます）。
2. 大規模モデルを設定します。
3. Sufy MCP を設定します。
   1. Cline アイコンをクリックしてプラグイン画面に入り、MCP Server モジュールを選択します。
   2. 「インストール済み」を選択し、「高度な MCP 設定」をクリックして、以下のテンプレートを使用して設定します。

   {
     "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 内のすべてのバケットをリストする ◦ Sufy の xxx バケット内のファイルをリストする ◦ Sufy の xxx バケット内の yyy ファイルの内容を読み取る ◦ Sufy の xxx バケット内の yyy 画像を 20% 縮小する

注意：Cline で MCP Server を作成する場合は、上記の設定をそのまま使用できます。

開発

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

git clone git@github.com:sufy/sufy-mcp-server.git
cd sufy-mcp-server

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

uv venv
source .venv/bin/activate  # Linux/macOS
# または
.venv\Scripts\activate  # Windows

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

uv pip install -r requirements.txt

4. サーバーを起動します。

uv --directory . run sufy-mcp-server

テスト

モデル制御プロトコルインスペクターを使用する

推奨ツール：モデル制御プロトコルインスペクター

# Node.js v22.4.0 が必要
npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server

ローカル MCP サーバーの例

1. 標準入出力モードで実行する（デフォルト）

uv --directory . run sufy-mcp-server

2. SSE モードで実行する（Web アプリケーションに適しています）

uv --