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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

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

Related MCP Servers

Together AI Image MCP Server
stefanskiasan
A
security
A
license
A
quality
Enables the generation of images using Together AI's models through an MCP server, supporting customizable parameters such as model selection, image dimensions, and output directory.
Last updated -
1
4
JavaScript
MIT License
MCP Flux Studio
jmanhype
-
security
A
license
-
quality
A server that integrates Flux's advanced image generation and manipulation features into AI coding assistants, enabling seamless text-to-image and image control workflows in IDEs like Cursor and Windsurf.
Last updated -
4
10
Python
MIT License
MCP Server for Replicate
tzafrir
-
security
A
license
-
quality
A FastMCP server implementation that provides a standardized interface for accessing AI models hosted on Replicate's API, currently supporting image generation with customizable parameters.
Last updated -
2
Python
MIT License
Workers MCP Demo
akazwz
-
security
F
license
-
quality
A demonstration project that uses Cloudflare Workers MCP to create custom AI tools that can be integrated with Claude, Cursor, and other AI assistants supporting the Model Context Protocol.
Last updated -
26
TypeScript

View all related MCP servers

Flux Cloudflare MCP