Flux Cloudflare MCP

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

generate_image

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

Related MCP Servers

FLUX Image Generator MCP Server
frankdeno
A
security
F
license
A
quality
An MCP server that generates images based on text prompts using Black Forest Lab's FLUX model, allowing for customized image dimensions, prompt upsampling, safety settings, and batch generation.
Last updated -
3
1
TypeScript
Remote MCP Server (Authless)
evimeyer
-
security
F
license
-
quality
A deployable MCP server on Cloudflare Workers that enables using custom tools with AI models without requiring authentication.
Last updated -
JavaScript
Remote MCP Server (Authless)
miguelplaza17
-
security
F
license
-
quality
A deployable MCP server on Cloudflare Workers that allows you to create custom AI tools without requiring authentication.
Last updated -
TypeScript
Remote MCP Server (Authless)
elizabethsiegle
-
security
F
license
-
quality
A Cloudflare Workers-based MCP server that enables AI tools without requiring authentication, allowing connection from Claude Desktop or the Cloudflare AI Playground.
Last updated -
6
JavaScript

View all related MCP servers

Flux Cloudflare MCP