Flux Cloudflare MCP
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 を提供します。
flux-api-workerリポジトリをフォークする
Cloudflare Workers にデプロイします。
Cloudflareダッシュボードで新しいワーカーを作成する
フォークしたリポジトリに接続する
必要な環境変数を設定します。
API_KEY: 認証用に選択したAPIキーCF_ACCOUNT_ID: CloudflareアカウントIDCF_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_URLAPI URL に置き換えます。変更を適用するにはカーソルを再起動してください
方法2: カーソルMCP設定を使用する
カーソルを開いて設定へ移動します
「MCP」または「モデルコンテキストプロトコル」セクションに移動します
「サーバーを追加」または同等のボタンをクリック
適切なフィールドに次のコマンドを入力します。
env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcpYOUR_TOKEN実際の Flux API トークンに置き換え、YOUR_API_URLAPI 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 ファイルを参照してください。
🔗 リソース
snakeying/flux-api-worker - シンプルな Flux API 実装
aigem/cf-flux-remix - ウェブ UI を備えた機能豊富な Flux API
Available Tools
1 toolgenerate_imageC
Generate an image from a text prompt using Flux model
Inputs: prompt (required), aspect_ratio, file_name, height, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is clearly defined and distinct by default.
Since there is only one tool, naming consistency is inherently perfect as there are no other names to compare it with. The tool name 'generate_image' follows a clear verb_noun pattern, but consistency cannot be assessed across multiple tools.
A single tool is generally too few for a server's purpose, as it limits functionality and suggests an incomplete or narrow scope. For a domain like image generation, one tool may be insufficient for comprehensive coverage, such as lacking variations, edits, or management operations.
The server appears focused on image generation, but with only a single tool for generating images from text prompts, there are significant gaps. Missing operations might include editing images, managing generated content, or handling different models, which could lead to agent failures in broader workflows.
Maintenance
Related MCP Connectors
MCP server for Flux AI image generation
Official FLUX MCP server. Generate, edit, vary, and browse images from Black Forest Labs.
Cloudflare Workers MCP server: ai-agent-scratchpad
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseBqualityDmaintenanceA TypeScript-based MCP server that enables text-to-image generation using Cloudflare's Flux Schnell model API.15MIT
- AlicenseCqualityDmaintenanceAn 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.31MIT
- FlicenseBqualityNot gradedmaintenanceAn MCP server that enables generating and editing high-quality images with natural language using Black Forest Labs' FLUX.1 Kontext Pro model.25 npm-
- AlicenseNot gradedqualityFmaintenanceAn MCP server that enables AI assistants to generate images using Black Forest Labs API and FLUX models, with automatic polling and image URL retrieval.17 npm1MIT