🌉 Forge Neo MCP

MCP対応のStable Diffusion WebUI Forge - Neo用MCPサーバー · MCPを話せるAIエージェントなら、自分のGPUで画像を生成できます

Claude — またはMCP対応のエージェント — に画像を頼むと、ローカルのForge Neoで生成されます。読み込まれているチェックポイントを確認し、そのモデルが期待するサンプリングパラメータとプロンプトスタイルを割り出し、プロンプトを書き、ファイルを返してくれます。

ステップやCFG、サンプラーを自分で指定する必要はありません（指定したい場合を除く）。それらはあなた自身の環境から取得されます：インスタンスの設定、過去の生成履歴、チェックポイントのメタデータ。判断できない場合は、推測せずに質問してきます。

[!IMPORTANT] Forge Neoは--api付きで実行する必要があります。Forgeのフォルダには何もインストールされません — 拡張機能もカスタムノードもありません。ブリッジはForgeが既に公開しているREST APIと通信します。

📋 目次

• 要件

• インストール

• 設定

• 初回実行

• 使い方

• ツール

• トラブルシューティング

• 機能概要

• ロードマップ

• クレジット

Related MCP server: Nano Banana

✅ 要件

Forgeが別のマシンで動いている場合のみ：そのマシンへのネットワークアクセス、および結果をbase64ではなくファイルパスで受け取りたい場合はファイル共有。

📦 インストール

1 · Forge NeoでAPIを有効にする

webui-user.bat（Windows）またはwebui-user.sh（Linux）を編集して--apiを追加します：

set COMMANDLINE_ARGS=--api

既存のフラグはそのままに、--apiを追加するだけです。Forgeを再起動します。

動作確認： http://127.0.0.1:7860/docsを開きます。/sdapi/v1/...エンドポイントが一覧表示されていれば、APIは有効です。

2 · ブリッジをインストールする

pip install git+https://github.com/eduardoabreu81/forgeneo-mcp

3 · エージェントに登録する

Claude Code

claude mcp add forgeneo -e FORGE_URL=http://127.0.0.1:7860 -- forgeneo-mcp

Claude Desktop、Cursor、またはmcp.jsonを持つクライアント

{
  "mcpServers": {
    "forgeneo": {
      "command": "forgeneo-mcp",
      "env": { "FORGE_URL": "http://127.0.0.1:7860" }
    }
  }
}

クライアントを再起動します — MCPサーバーは起動時に読み込まれるため、ツールは新しいセッションで表示されます。

⚙️ 設定

FORGE_URL以外はすべてオプションで、それもForgeが127.0.0.1:7860にない場合のみ必要です。

すべて同じマシン上にある場合

他に何もする必要はありません — デフォルトでカバーされます。

Forgeが別のマシンにある場合

Forgeを--listen --api付きで起動し、ブリッジをそのマシンに向けてパスをマッピングします：

claude mcp add forgeneo \
  -e FORGE_URL=http://gpu-box:7860 \
  -e FORGE_PATH_MAP='D:/forge-neo=//gpu-box/share/forge-neo' \
  -- forgeneo-mcp

FORGE_PATH_MAPはForgeが呼ぶ名前 = あなたが呼ぶ名前として読み取られます。ForgeはD:\forge-neo\output\...のようなパスを報告します。同じフォルダに\\gpu-box\share\forge-neo\output\...として到達する場合、そのマッピングによりブリッジはメガバイト単位のbase64ではなくファイルパスを渡せます。

これがなくてもすべて機能します — base64で受け取るだけです。

[!NOTE] --listenはパスワードなしでAPIをネットワークに公開します。それが問題になる環境では、Forgeに--api-auth user:passwordを追加し、FORGE_AUTHをそれに合わせて設定してください。

🚀 初回実行

新しいセッションを開き、エージェントに接続確認を依頼します。capabilitiesを呼び出して、見つかった内容を報告します：

reachable    true
counts       checkpoints · loras · samplers · schedulers · modules
filesystem   file paths        (or: base64 — no readable output dir)
history      how many past generations it could read

確認する価値のある3つの項目：

• filesystem: base64 — FORGE_PATH_MAPが欠落しているか誤っています。致命的ではありませんが、結果が会話を肥大化させます。

• history: 0 — 過去の作業から学習できません。通常は出力フォルダに到達できないか、Forgeがメタデータを保存していません（トラブルシューティングを参照）。

• loras: 0 でLoRAがインストールされている場合 — Forge自身のLoRAリストが空です。UIで更新してください。

💬 使い方

頼むだけです。エージェントが残りを処理します。

「冬のハイキングについての記事のカバー画像」

読み込まれているものを確認し、そのモデルが散文を好むかタグを好むかを判断し、それに応じてプロンプトを書き、生成します。

「同じものだけど、サムネイルに使うスタイルで」

LoRAを検索し、該当するものを見つけ、トリガーワードと通常使用する重みを取得し、プロンプトに書き込みます — 送信された内容が読めるように可視化されます。

「ポートレート用のモデルに切り替えて」

そのチェックポイントを読み込みます。異なるアーキテクチャに属する場合、対応するVAEとテキストエンコーダーも一緒に読み込まれます。

直接尋ねる価値のあるその他のこと：

• 「どのモデルが読み込まれていて、どうプロンプトすればいい？」 — 平易な言葉でのプロファイル

• 「このチェックポイントで使えるLoRAはどれ？」 — 互換性のあるものに絞り込み

• 「fluxのセットアップは完了してる？」 — VAEとテキストエンコーダーを確認

• 「停止」 — 実行中の生成を中断

🛠️ ツール

エージェントが自動的に選択します。ここにあるのは、何ができるかを知るためのリストです。

🔧 トラブルシューティング

Forgeに到達できないと言われる Forgeが--api付きで実行され、http://127.0.0.1:7860/docsに/sdapi/v1/エンドポイントが一覧表示されていることを確認してください。Forgeが別のマシンにある場合は--listenも必要で、ファイアウォールが妨げになっている可能性があります。

結果がbase64で返ってきて会話が溢れる FORGE_PATH_MAPが欠落しているか一致していません。Forgeが報告するパス — 任意の生成の情報に表示されます — と、同じフォルダに到達するために使用するパスを比較してください。

通常の設定を認識しない 過去の画像から学習しますが、そのためにはForgeが生成パラメータを保存する必要があります。設定 → 画像保存で、**「生成パラメータのテキスト情報をpngファイルにチャンクとして保存」**を有効にするか、.txtサイドカーをオンにしてください。どちらもない場合、出力にパラメータが含まれず、アーキテクチャのデフォルトにフォールバックします。

SDXLチェックポイントの系統を何度も聞かれる Pony、Illustrious、Animagine、標準SDXLはファイルからは区別できません — 同じテンソル、同じプリセット、異なるプロンプト語彙。一度答えるとファイルごとに記憶され、二度と聞かれません。

アーキテクチャ切り替え後に画像がおかしくなる モジュールチェックを依頼してください。Forgeは各プリセットで最後に選択されたVAEとテキストエンコーダーを記憶しているため、別のプリセットがアクティブな状態でチェックポイントを読み込むと、誤ったものが付いたままになることがあります。チェックは何が欠落しているか、正しいファイルが既にインストールされているかを示します。

容量不足でダウンロードが拒否された 意図的です — 数ギガバイト進んだ後に失敗するのではなく、開始前に空き容量を確認します。空き容量を確保するか、bf16の代わりにfp8_scaledのような軽量ビルドを選択してください。

🎯 機能概要

• モデルに合ったサンプリングパラメータ。 利用可能な場合はあなた自身の過去の生成から、そうでない場合はインスタンスの設定から取得されます — このリポジトリの表からではありません。

• 正しいプロンプト語彙。 役立つ場合は品質タグ、害になる場合はなし：キャプションで訓練されたモデルにmasterpiece, best qualityを追加すると、プロンプトが改善されるどころか薄まります。

• 検索可能なLoRA。 名前、タグ、トリガーワード、説明で検索でき、実際に使用する重み付き。プロンプトに何かが追加される際は必ず表示されます。

• 正直な不確実性。 証拠が尽きたところでそれを伝え、質問します。黙って推測することはありません。

• モジュール健全性チェック。 プリセットが誤ったVAEやテキストエンコーダーを拾った場合に気づき、欠落しているものの公式ダウンロード先を示します。

各回答がどのように導出されるかのメモは、それを導出するコードの隣のソースにあります。

🗺️ ロードマップ

• ビデオ（Wan） — Forgeは4n+1の倍数のフレーム数でビデオを生成し、ffmpegでエンコードしますが、APIは結果のパスを破棄します。ディスクからの収集は画像が返ってくる方法として既に実装されているため、これは主に配管の問題です。

• EXIFメタデータ — JPEGとWebPは.txtサイドカーがオフの場合、パラメータをEXIFに保存します。その組み合わせは現在履歴を生成しません。

• 認証 — FORGE_AUTHは実装されていますが、実際の--api-authインスタンスに対してテストされていません。

📄 クレジット

• Forge Neo by Haoming02 — ブリッジの接続先WebUI、およびモジュール参照の背後にあるDownload Modelsウィキ

• モデル作者 — カードに実際のプロンプトガイダンスを公開している方々。方言テーブルは推測ではなくそれらから構築されています

• Model Context Protocol — プロトコルとPython SDK

• CivitAI — オプションのルックアップで使用される公開ハッシュ別エンドポイント

📜 ライセンス

MIT — LICENSEを参照

Stable Diffusionコミュニティのために❤️を込めて

バグ報告 • 機能リクエスト • ディスカッション • ☕ Ko-fi