mcpField
F
FLUX

FLUX

ローカル
github.com/black-forest-labsメディア・デザイン189 週間前に更新

FLUX について

FLUX は、MCP クライアントから画像や動画を生成・編集できる Black Forest Labs のホスト型 MCP サーバーです。バーチャル試着、生成履歴、プロンプトガイドも利用できます。

主な機能

  1. 01テキストからの画像生成と画像編集
  2. 02複数画像の合成とバーチャル試着
  3. 03FLUX 3 による動画生成と高品質化
  4. 04バリエーション生成と履歴の閲覧
  5. 05公式プロンプトガイド

活用シーン

  1. 01画像案をまとめて生成
  2. 02プロンプトでアップロード画像を編集
  3. 03静止画やキーフレームから動画を作成
  4. 04過去の結果から編集やバリエーションを継続

MCP 対応

https://mcp.bfl.ai のホスト型リモートサーバーを通じて、画像・動画ツール、リソース、プロンプトガイドを MCP クライアントに提供します。OAuth でログインし、生成履歴やクレジット残高も確認できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"flux": {
"command": "npx",
"args": [
"-y",
"mcp-remote"
]
}
}
}
起動コマンドnpx -y mcp-remote

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmcp-remote

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Black Forest Labs

FLUX MCP

いつものツールにFLUXを取り入れましょう。
MCP 対応クライアントから、FLUXや動画を生成、編集、変化させ、閲覧できます。

MCP Registry License: MIT Docs

インストール · ショーケース · ツール · スキル · 使用例 · トラブルシューティング


FLUX MCP サーバーは、テキストからの画像生成、画像編集、複数の参照画像を使った合成、バーチャル試着、FLUX 3 動画、バリエーション生成、履歴など、FLUXのすべてのツールキットを、Model Context Protocolに対応するあらゆるクライアントに提供します。複数の候補を並列生成したり、プロンプトで添付画像を編集したり、写真に衣服を試着させたり、静止画を音声付きの動画クリップにしたり、気に入った結果からバリエーションを作成したりできます。APIコードは不要で、会話にキーを貼り付ける必要もありません。

  • ホスト型、リモート、OAuthのみ。 https://mcp.bfl.aiに接続します。BFLアカウントでサインインし、請求先の組織を選べば完了です。
  • すべてのFLUX.2モデルに対応。 Pro、Max、Klein(4Bおよび9B)、Flexを利用できます。タスクに適したモデルはクライアントが選択します。
  • FLUX 3動画。 テキストからの動画生成、キーフレームからの画像を使った動画生成、同期音声付きの動画継続に対応し、ドラフトプレビューも含まれます。
  • チャット向けに設計。 1つのプロンプトにつき最大8枚の画像を並列生成できます。添付画像を編集したり、履歴を閲覧して再利用したりできます。
  • 用途に特化したプロンプトガイド。 画像生成とFLUX 3のワークフローに特化した公式BFLガイドを利用できます。
  • 料金はBFLに直接お支払い。 仲介業者も共有クォータもありません。現在の料金はこちらです:bfl.ai/pricing。

インストール

Claude — デスクトップおよび claude.ai
  1. 設定 → コネクターを開きます。
  2. カスタムコネクターを追加をクリックします。
  3. 名前にFLUX、URLにhttps://mcp.bfl.aiを指定します。
  4. 接続をクリックしてサインインし、請求先のBFL組織を選択します。
Claude Code
claude mcp add --transport http FLUX https://mcp.bfl.ai

初回使用時に、OAuth用のブラウザーが開きます。トークンは自動的に更新されます。

Cursor

ワンクリック: Cursorに追加 — FLUXサーバーがあらかじめ入力された状態でCursorが開きます。

手動 — .cursor/mcp.jsonに追加します:

{
  "mcpServers": {
    "FLUX": {
      "url": "https://mcp.bfl.ai"
    }
  }
}
Codex
codex mcp add flux --url https://mcp.bfl.ai
codex mcp login flux

または、~/.codex/config.tomlに追記します:

[mcp_servers.flux]
url = "https://mcp.bfl.ai"
Windsurf

~/.codeium/windsurf/mcp_config.jsonを編集します(WindsurfではurlではなくserverUrlを使用します):

{
  "mcpServers": {
    "FLUX": {
      "serverUrl": "https://mcp.bfl.ai"
    }
  }
}

Cascadeパネルからプラグインを再読み込みします。FLUXを初めて呼び出すと、サインイン用のブラウザーが開きます。

その他のMCPクライアント(mcp-remoteを介したstdioブリッジ)

stdio MCPには対応しているものの、OAuthフローを自身では処理しないクライアント向けです。たとえば、Hermes(Nous Research)や、静的なベアラートークンのみを受け付ける同様のツールが該当します:

{
  "mcpServers": {
    "FLUX": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bfl.ai"]
    }
  }
}

mcp-remoteはOAuth用のブラウザーを開き、トークンを~/.mcp-auth/にキャッシュして、自動的に更新します。


使用例

1つのプロンプトで複数の候補を生成

「エディトリアルなポートレートのバリエーションを4つ生成してください。照明、配色、雰囲気に変化をつけてください。」

README の画像 README の画像 README の画像 README の画像

必要なのがメインビジュアル1枚だけなら、1枚だけ生成

「浅い砂漠の塩湖を真上から撮影した航空写真。強烈な直射日光。」

README の画像

チャットから画像を直接編集

「砂の上にラクダを追加してください。」

編集前編集後
README の画像README の画像
生成履歴をすべて確認して再利用

「最近のFLUX生成結果を見せてください。」

生成結果はすべて保存されます。タイルをタップすると、編集、バリエーション作成、ダウンロードができます。過去の画像から、ワンクリックでバリエーションを作成できます。


ツール

クライアントはプロンプトに基づいて呼び出すツールを選択するため、ツール名を指定して呼び出す必要はありません。

ツール機能
generate_image1~8 枚の画像を並列で生成します。プロンプトを通じて、テキストからの画像生成、画像編集、複数の参照画像を使った合成、スタイル変換、インペインティング形式の編集、アウトペインティングに対応しています。
vtoバーチャル試着 — 参照画像にある衣服、帽子、サングラス、靴、バッグなど、身に着けるアイテムを人物(またはペット)に着せます。顔、髪、ポーズは維持され、身に着けるアイテムだけが変わります。
generate_videoFLUX 3 で1~4 本の動画を並列で生成します。テキストからの動画生成、キーフレームからの画像を使った動画生成、既存動画の続きの生成に対応しています。長さは 5~20 秒で、音声も同期されます。
enhance_videoドラフト動画を最高画質で再レンダリングします。選択したドラフトと同じ構図、シード、プロンプトプランが使われます。
generate_variations前回の生成結果(request_id で識別)と同じ方向性の画像を N 枚追加で生成します。デフォルトは 4 枚、最大 8 枚です。
get_history最近の生成結果を、タイルごとの「バリエーション」「編集」「コピー」「ダウンロード」アクションを備えたサムネイルグリッドで一覧表示します。キーセットページネーションと日付フィルターに対応しています。
get_credits残りの BFL クレジット残高を返します。
list_skills公式のBFL プロンプトガイドを一覧表示します。画像生成のベストプラクティス、動画の演出、音声と対話、キーフレーム、製品広告、アーカイブ風の表現、API 統合が含まれます。
get_skill名前を指定してガイドを取得します。長いガイドでは、導入部とセクション一覧が返されます。タスクに必要なセクションを取得してください。
モデル

generate_image で利用できるモデル:

モデル用途
flux2_pro_preview (デフォルト)日常的な作業 — 品質と速度のバランスに優れています
flux2_maxメインビジュアル、最終アセット — 最高品質
flux2_klein_9b_preview高速な反復作業、最大 4 枚の入力画像に対応
flux2_klein_4b最速のオプション
flux2_flexタイポグラフィと読みやすいテキスト

モデルの全カタログ、モデルごとの参照画像の上限、FLUX Tools(vto)、FLUX 3 動画も、bfl://models MCP リソースとして公開されています。

動画

generate_video は、音声を同期させた5~20秒の24fps MP4クリップをレンダリングします。1回の呼び出しで最大4本を並列処理できます。各リクエストでは、次の3つのモードのいずれかを使用します。

モード入力出力
t2vプロンプトのみ説明に基づいて生成されたクリップ
i2vプロンプト + 1~10枚のキーフレーム画像1枚の場合は、その正確な開始フレームから静止画をアニメーション化します。2枚の場合は開始フレームと終了フレームをつなぎます。3~10枚の場合は、クリップ全体に均等に配置したストーリーボードになります(duration の明示が必要です)
v2vプロンプト + ソース動画ソース動画の最後の数秒から続く、音声付きの動画
  • プロンプトは文章で記述します。 FLUX 3 はプロンプトを推論し、レンダリング前に生成内容を計画します。シーン、動き、音声を説明してください。動画ではシードやモデルのパラメーターは使用できません。
  • キーフレームには、以前の結果(request_id)、アップロードした画像、または公開 URL を指定します。任意で、キーフレームごとにタイムスタンプ(秒単位、昇順)を指定して、クリップ内の正確な位置を固定できます。タイムスタンプはすべてのキーフレームに指定するか、どれにも指定しないでください。duration を auto に設定すると、クリップは最後のタイムスタンプまで再生されます(最大20秒)。
  • v2v のソース動画には、以前の generate_video の結果、50 MB 以下の添付 MP4、または公開 MP4 URL を指定できます。
  • 形式の設定。 duration:5~20秒または auto(デフォルト)。aspect_ratio:auto(デフォルト)、21:9、2:1、16:9、4:3、1:1、3:4、9:16。resolution:hd(デフォルト、704p相当)または fhd(1080p相当のキャンバス上で動画アップサンプラーが仕上げます)。generate_audio はデフォルトで有効です。
  • ドラフトで試行錯誤します。 draft: true を指定すると、計画された生成内容をそのまま高速かつ低ステップでプレビューできます(hd のみ)。低コストのドラフトを複数作成して最適なものを選び、enhance_video でその request_id を指定してフル品質で再レンダリングします。
  • レンダリングには数分かかります。 長いクリップでは約1時間かかることもあります。ツールは保留中の request_id をすぐに返します。チャットを閉じても結果は保持され、自動的に再開されます。
  • 参照ベースの条件付け(人物の同一性や動きの参照)は、動画機能には含まれていません。専用の r2v モードは後日追加されます。

プロンプト作成のスキル

このサーバーには、black-forest-labs/skills の専門的なプロンプトガイドが付属しています。3つの方法で提供されるため、どのクライアントでも少なくとも1つの方法で利用できます。これらのガイドでは特定のワークフローを扱います。一般的な FLUX 3 のプロンプトガイドはまだありません。

  • ツール — list_skills と get_skill(name)。ChatGPT を含む、あらゆる環境で使用できます。
  • リソース — リソースピッカーに対応するクライアント(Claude、Cursor)向けの bfl://skills/<name>。
  • プロンプト — クライアントが対応している場合に使える、スラッシュプロンプト skill_<name_with_underscores>(例:skill_flux_image_best_practices)。

"どんな FLUX スキルがありますか?" と尋ねるか、商品広告、Super 8 の映像、セリフの演出など、専門的な内容をそのままリクエストしてください。生成ツールは、プロンプトを作成する前に、対応するガイドをクライアントに提示します。


プロンプトの例

FLUX に接続したら、クライアントで次のプロンプトを試してください。

Generate 4 editorial portrait variants — varied lighting, palette, and mood.
Use FLUX.2 [pro] at 1440×1792.
A top-down aerial photograph of shallow desert salt pools at golden hour,
intense direct sunlight, #FF6B6B and #F5E6D3 mineral deposits, FLUX.2 [max].
[attach an image]
Add a camel on the sand. Preserve the rest of the composition exactly.
Generate a movie poster with the title "MIRAGE" in 1970s grindhouse type,
high-contrast cyan and orange. Use FLUX.2 [flex].
[attach a selfie]
Try this on me — a red Nike Tech Fleece hoodie, oversized fit.
[attach an image]
Animate this into a 10-second clip — slow push-in, wind through the palms,
distant surf.
Generate 3 draft videos of a paper lantern rising over a night market,
each with a different camera move. I'll enhance the best one.
Show me my recent FLUX generations.
[click Variations on a past image]
4 more like this one, vary the lighting.

プロンプトのヒント

  • 主題を先に記述します。 最も重要な物体、人、シーンを最初に書きます。
  • 照明を説明します。 「柔らかなゴールデンアワーの光」 や 「曇天の拡散したスタジオ照明」 といった表現は、モデルに役立つ指示になります。
  • 16進数カラーコードを使います。 #FF6B6B (コーラルピンク) は、「ピンクがかった赤」 よりも正確です。
  • 描画するテキストは引用符で囲みます。 タイポグラフィ、ラベル、ポスター、看板には、正確な文字列を引用符で指定してください。
  • 否定的なプロンプトは避けます。 FLUX は避けたいもののリストではなく、説明した内容に反応します。
  • 結果を見ながら反復します。 別案には Variations を使い、生成した画像をさらに調整するには Edit を使います。

このサーバーでは、特定のワークフロー向けに専門的なガイドを提供しています。一般的な FLUX 3 のプロンプトガイドはまだありません。

トラブルシューティング

接続後にツールが表示されない
  • Claude Desktop / claude.ai: Settings → Connectors で、FLUX が Connected と表示されていることを確認します。エラーが表示されずに失敗した場合は、削除してから再度追加します。OAuth ウィンドウを開けるよう、ポップアップがブロックされていないことを確認してください。
  • Claude Code: claude mcp list にサーバーが表示されるはずです。
  • Codex: codex mcp list に flux が表示されるはずです。追加後、新しい Codex セッションを開始してください。
  • 簡単な動作確認:クライアントに 「BFL のクレジットを確認して」 と尋ねます。
ツールの更新またはサーバーの再接続
  • Claude.ai / Desktop: Settings → Connectors で FLUX をオフにしてからオンにするか、Reconnect をクリックします。
  • Claude Code: /mcp でステータスと再認証を確認できます。完全な再構築:
    claude mcp remove FLUX
    claude mcp add --transport http FLUX https://mcp.bfl.ai
    
  • Codex: codex mcp login flux を実行します。完全な再構築:
    codex mcp remove flux
    codex mcp add flux --url https://mcp.bfl.ai
    
  • mcp-remote clients: rm -rf ~/.mcp-auth を実行し、クライアントを再起動して OAuth を新たに実行します。
認証または請求に関するエラー
  • bfl.ai で BFL アカウントをお持ちであることを確認してください。
  • コネクターを切断してから再接続し、OAuth をやり直します。
  • 選択した組織に十分なクレジットがあることを確認してください。
  • クライアントに BFL のクレジットを確認するよう依頼し、残高を確認します。
生成の読み込みが続く

大量のバッチ、FLUX.2 [max]、複雑な編集は、小規模な生成より時間がかかります。ビジュアル MCP クライアントでは、画像ビューが自動的に更新されます。

動画のレンダリングには数分かかり、長いクリップでは最大約 1 時間かかります。リクエストは保留中の状態ですぐに返され、チャットを閉じて後から戻った場合でも自動的に再開されます。

添付した画像や動画の編集に失敗する

MCP クライアントには、添付メディアを BFL にアップロードする権限が必要です。クライアントのサンドボックスで外向きの HTTPS 通信がブロックされている場合は、*.bfl.ai を許可するか、代わりに公開 URL を渡してください。動画のアップロードは MP4 のみで、最大 50 MB です。

請求対象の組織を切り替える

クライアントで FLUX コネクターを切断してから再接続します。OAuth フローで、組織を再度選択するよう求められます。


エージェントスキル(関連リポジトリ)

MCP とエージェントスキルは、それぞれ異なる問題を解決します。

MCP(このリポジトリ)エージェントスキル
機能チャット内で画像を直接生成、編集、バリエーション作成、閲覧しますFLUX API コードの書き方をコーディングエージェントに教えます
最適な用途Claude やその他の MCP クライアント内でのクリエイティブな作業FLUX API を呼び出すアプリケーションの構築

両方を活用してください。互いに補完し合います。また、スキルリポジトリのプロンプトガイドも MCP 経由で直接提供されます(プロンプトスキルを参照)。


リンク


ライセンス

MIT © Black Forest Labs

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。