Flux Schnell MCP Server

Flux Schnell MCP サーバー

Replicate API を通じて Flux Schnell モデルを呼び出し、画像を生成する MCP（Model Context Protocol）ベースのサーバーです。

機能

• 画像を生成するgenerate_imageツールを提供します
• テキストプロンプトをカスタマイズできます
• Replicate API との通信を自動的に処理します
• エラー処理とレスポンスに完全に対応しています

前提条件

1. Node.js（v14 以降）
2. Replicate API Token
3. MCP 対応環境（Claude Desktop など）

Replicate API Token の取得

1. Replicate 公式サイトにアクセスして、アカウントを登録します
2. ログイン後、API Tokens ページにアクセスします
3. 「Create API token」をクリックして、新しいトークンを作成します
4. 生成されたトークンをコピーします（形式の例：r8_xxxxxx）

インストール

1. プロジェクトをクローンして、依存関係をインストールします：

git clone [repository-url]
cd flux-schnell-mcp
npm install

2. サーバーをビルドします：

npm run build

設定

Claude Desktop の設定

1. 設定ファイルを開きます：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json

2. サーバーの設定を追加します：

{
  "mcpServers": {
    "flux-schnell": {
      "command": "node",
      "args": ["/path/to/flux-schnell-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

VSCode Roo の設定

1. 設定ファイルを開きます：

   • Linux：~/.vscode-remote/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • MacOS：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • Windows：%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

2. 上記と同じサーバー設定を追加します。

使用方法

サーバーはgenerate_imageというツールを提供しており、MCP 経由で呼び出せます：

<use_mcp_tool>
<server_name>flux-schnell</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "a beautiful sunset over the ocean, digital art style"
}
</arguments>
</use_mcp_tool>

パラメーターの説明

• prompt：画像を生成するためのテキスト説明（必須）
  • より良い生成結果を得るには、詳細な説明を使用することをおすすめします
  • スタイル、シーン、詳細などの情報を含めることができます

レスポンス形式

サーバーは、生成された画像の URL やその他のメタデータを含む、Replicate API の完全なレスポンスを返します。

デバッグ

MCP サーバーは stdio で通信するため、デバッグが難しい場合があります。MCP Inspectorの使用をおすすめします：

npm run inspector

Inspector は URL を表示します。その URL にアクセスすると、ブラウザーでデバッグツールを使用できます。

注意事項

1. Replicate API Token は適切に管理し、他の人と共有しないでください
2. 設定ファイルで正しいファイルパスを使用していることを確認してください
3. 画像の生成には時間がかかる場合があります。レスポンスが返るまでお待ちください
4. エラーが発生した場合は、API Token が正しいことと、ネットワーク接続に問題がないことを確認してください