Integrations

Leverages Cloudflare Workers to securely process image generation requests through Black Forest Labs' Flux model
Provides access to Black Forest Labs' Flux model for high-quality image generation based on text prompts
Utilizes TypeScript 4.9+ for type safety and modern JavaScript features in the MCP implementation

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を使用してテキスト補完を取得します

📦 インストール

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 を提供します。

flux-api-workerリポジトリをフォークする
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")
デプロイされると、API はhttps://your-worker-name.your-subdomain.workers.devで利用できるようになります。
この URL をFLUX_API_URLとして使用し、選択した API キーをFLUX_API_TOKENとして使用します。

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

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

cf-flux-remixリポジトリのインストール手順に従ってください。
デプロイされると、APIはデプロイされたURLで利用できるようになります。
この 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を使用する

プロジェクトディレクトリに.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"]
    }
  }
}

YOUR_TOKEN実際の Flux API トークンに置き換え、 YOUR_API_URL API URL に置き換えます。
変更を適用するにはカーソルを再起動してください

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

カーソルを開いて設定へ移動します
「MCP」または「モデルコンテキストプロトコル」セクションに移動します
「サーバーを追加」または同等のボタンをクリック
適切なフィールドに次のコマンドを入力します。

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

YOUR_TOKEN実際の Flux API トークンに置き換え、 YOUR_API_URL API URL に置き換えます。
設定を保存し、必要に応じてカーソルを再起動します。

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

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"
      }
    }
  }
}

💻 地域開発

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

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

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

npm install

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

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への接続を許可していることを確認してください

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

このモデルには安全フィルターが組み込まれており、特定のプロンプトをブロックする可能性があります。
問題となる可能性のあるコンテンツを避けるため、プロンプトを修正してみてください。

🤝 貢献する

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

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

📄 ライセンス

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

🔗 リソース

モデルコンテキストプロトコルドキュメント
Cloudflare Workers ドキュメント
フラックスモデルのドキュメント
MCP TypeScript SDK
snakeying/flux-api-worker - シンプルな Flux API 実装
aigem/cf-flux-remix - ウェブ UI を備えた機能豊富な Flux API

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI アシスタントが Cloudflare Workers 経由で Black Forest Labs の Flux モデルを使用して画像を生成できるようにする MCP サーバー。