Flux Cloudflare MCP

Cloudflare Worker API を介してBlack Forest Labs の Flux モデルを使用して画像を生成する機能を AI アシスタントに提供する強力な Model Context Protocol (MCP) サーバー。

インストール•機能•使用方法•ドキュメント•貢献

🌟 特徴

• 🖼️ 高品質画像生成：最先端の画像生成モデルであるFluxへのアクセス

• 🤖 シームレスなAI統合：ClaudeのようなAIアシスタントが直接画像を生成できるようにします

• 🎛️ カスタマイズ可能なパラメータ: アスペクト比、推論ステップなどを制御

• 🔌 MCP 互換: すべての MCP クライアント (Cursor、Claude Desktop、Cline、Zed など) で動作します。

• 🔒 ローカル処理：すべてのリクエストはCloudflare Workerを通じて安全に処理されます

• 💬 チャット補完: 同じAPIを使用してテキスト補完を取得します

Related MCP server: Remote MCP Server (Authless)

📦 インストール

NPXによる直接使用

ソースから

🚀 Flux API の設定

このMCPサーバーが機能するには、Flux APIエンドポイントが必要です。APIの設定には2つのオプションがあります。

オプション 1: snakeying/flux-api-worker を使用してデプロイする (推奨)

snakeying/flux-api-worker は、 Flux モデルにアクセスするためのシンプルで効率的な Cloudflare Worker を提供します。

1. flux-api-workerリポジトリをフォークする

2. Cloudflare Workers にデプロイします。

   • Cloudflareダッシュボードで新しいワーカーを作成する

   • フォークしたリポジトリに接続する

   • 必要な環境変数を設定します。

     • API_KEY : 認証用に選択したAPIキー

     • CF_ACCOUNT_ID : CloudflareアカウントID

     • CF_API_TOKEN : Workers AI アクセス用の Cloudflare API トークン

     • FLUX_MODEL : 使用する Flux モデル (デフォルト: "@cf/black-forest-labs/flux-1-schnell")

3. デプロイされると、API はhttps://your-worker-name.your-subdomain.workers.devで利用できるようになります。

4. この URL をFLUX_API_URLとして使用し、選択した API キーをFLUX_API_TOKENとして使用します。

オプション2: aigem/cf-flux-remixを使用してデプロイする

より機能豊富な Web UI の実装には、 aigem/cf-flux-remix を使用できます。

1. cf-flux-remixリポジトリのインストール手順に従ってください。

2. デプロイされると、APIはデプロイされたURLで利用できるようになります。

3. この URL をFLUX_API_URLとして使用し、設定した API キーをFLUX_API_TOKENとして使用します。

📚 ドキュメント

利用可能なツール

generate_image

Flux モデルを使用して、テキスト プロンプトに基づいて画像を生成します。

🔧 使用方法

カーソル統合

方法1: mcp.jsonを使用する

1. プロジェクト ディレクトリに.cursor/mcp.jsonファイルを作成または編集します。

2. YOUR_TOKEN実際の Flux API トークンに置き換え、 YOUR_API_URL API URL に置き換えます。

3. 変更を適用するにはカーソルを再起動してください

方法2: カーソルMCP設定を使用する

1. カーソルを開いて設定へ移動します

2. 「MCP」または「モデルコンテキストプロトコル」セクションに移動します

3. 「サーバーを追加」または同等のボタンをクリック

4. 適切なフィールドに次のコマンドを入力します。

5. YOUR_TOKEN実際の Flux API トークンに置き換え、 YOUR_API_URL API URL に置き換えます。

6. 設定を保存し、必要に応じてカーソルを再起動します。

クロードデスクトップ統合

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

💻 地域開発

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

2. 依存関係をインストールします:

3. プロジェクトをビルドします。

🛠 技術スタック

• モデルコンテキストプロトコル SDK - コア MCP 機能

• Cloudflare Workers - 画像生成のためのサーバーレスAPI

• TypeScript - 型安全性と最新のJavaScript機能

• Zod - ランタイム型検証

⚙️ 構成

サーバーには次の環境変数が必要です。

• FLUX_API_TOKEN : Flux API での認証に使用する API トークン

• FLUX_API_URL : デプロイされた Flux API の URL (snakeying/flux-api-worker または aigem/cf-flux-remix から)

🔍 トラブルシューティング

よくある問題

認証エラー

• FLUX_API_TOKENが環境で正しく設定されていることを確認してください

• Flux APIで直接テストしてトークンが有効であることを確認します

API接続の問題

• Flux API (Cloudflare Worker) が実行され、アクセス可能であることを確認します

• ネットワークがCloudflare Workersへの接続を許可していることを確認してください

安全フィルターが作動しました

• このモデルには安全フィルターが組み込まれており、特定のプロンプトをブロックする可能性があります。

• 問題となる可能性のあるコンテンツを避けるため、プロンプトを修正してみてください。

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

🔗 リソース

• モデルコンテキストプロトコルドキュメント

• Cloudflare Workers ドキュメント

• フラックスモデルのドキュメント

• MCP TypeScript SDK

• snakeying/flux-api-worker - シンプルな Flux API 実装

• aigem/cf-flux-remix - ウェブ UI を備えた機能豊富な Flux API