Flux cf

Flux Cloudflare MCP

Cloudflare Worker API を介して Black Forest Labs' Flux model を使用し、AI アシスタントが画像を生成できるようにする強力な Model Context Protocol（MCP）サーバーです。

インストール • 機能 • 使い方 • ドキュメント • コントリビューション

---

🌟 機能

• 🖼️ 高品質な画像生成：最先端の画像生成モデルである Flux を利用できます
• 🤖 シームレスな AI 連携：Claude などの AI アシスタントが画像を直接生成できるようにします
• 🎛️ カスタマイズ可能なパラメーター：アスペクト比や推論ステップなどを制御できます
• 🔌 MCP 互換：あらゆる MCP クライアント（Cursor、Claude Desktop、Cline、Zed など）で動作します
• 🔒 ローカル処理：すべてのリクエストは Cloudflare Worker を通じて安全に処理されます
• 💬 チャット補完：同じ API を使用してテキスト補完を取得できます

📦 インストール

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 repository をフォークします
2. Cloudflare Workers にデプロイします。
   • Cloudflare ダッシュボードで新しい Worker を作成します
   • フォークしたリポジトリに接続します
   • 必要な環境変数を設定します。
     • 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 repository のインストール手順に従います
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")
}

🔧 使い方

Cursor との連携

方法 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. 変更を適用するため、Cursor を再起動します

方法 2：Cursor MCP 設定を使用

1. Cursor を開き、Settings に移動します
2. 「MCP」または「Model Context Protocol」セクションに移動します
3. 「Add Server」または同等の項目をクリックします
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. 設定を保存し、必要に応じて Cursor を再起動します

Claude Desktop との連携

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

🛠 技術スタック

• Model Context Protocol 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 ファイルをご覧ください。

🔗 リソース

• Model Context Protocol のドキュメント
• Cloudflare Workers のドキュメント
• Flux モデルのドキュメント
• MCP TypeScript SDK
• snakeying/flux-api-worker - シンプルな Flux API の実装
• aigem/cf-flux-remix - Web UI を備えた多機能な Flux API