Flux Schnell MCP

🚀 基于MCPのFlux Schnell画像生成サーバー

このサーバーはMCP（モデルコンテキストプロトコル）に基づいて構築されており、Replicate APIを通じてFlux Schnellモデルを呼び出し、画像を生成することができます。

✨ 主な機能

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

応答形式

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

デバッグ

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

npm run inspector

InspectorはURLを提供し、ブラウザでデバッグツールにアクセスできます。

注意事項

1. Replicate API Tokenを適切に保管し、他人に共有しないでください。
2. 設定ファイルで正しいファイルパスを使用していることを確認してください。
3. 画像生成には時間がかかる場合があり、応答を待つ際には忍耐が必要です。
4. エラーが発生した場合は、API Tokenが正しいか、ネットワーク接続が正常かを確認してください。