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: FLUX Image Generator MCP Server

📦 インストール

NPXによる直接使用

FLUX_API_TOKEN=your_token FLUX_API_URL=your_api_url npx -y flux-cloudflare-mcp

ソースから

# Clone the repository
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

# Install dependencies
npm install

# Build the project
npm run build

🚀 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 モデルを使用して、テキスト プロンプトに基づいて画像を生成します。

{
  prompt: string;                // Required: Text description of the image to generate
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
}

🔧 使用方法

カーソル統合

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

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

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}

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

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

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

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

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

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

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

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

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

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "npx",
      "args": ["-y", "flux-cloudflare-mcp"],
      "env": {
        "FLUX_API_TOKEN": "YOUR_TOKEN",
        "FLUX_API_URL": "YOUR_API_URL"
      }
    }
  }
}

💻 地域開発

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

git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

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

npm install

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

npm run build

🛠 技術スタック

• モデルコンテキストプロトコル 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