sdnext-mcp

SD.Next（Stable Diffusion Next）WebUI 向けの Model Context Protocol（MCP）サーバーです。

SD.Next の REST API（/sdapi/v1/* + /sdapi/v2/civitai/*）を 125 個の MCP ツールとしてラップし、LLM ホスト（Claude Desktop、DSH など）がテキストから画像への生成、画像から画像への変換、コントロール誘導生成、アップスケーリング、ディテーラー、LoRA、スクリプト、キャプション/タグ付け/VQA、モデルとオプションの管理、サーバー内部情報の取得、ファイル/ギャラリー、CivitAI など、SD.Next のあらゆる利用シナリオを操作できるようにします。

これは薄い HTTP クライアントです。 Python を組み込んでおらず、WebUI を起動しません。SD.Next を --api --listen 付きでご自身で実行する必要があります。MCP サーバーは HTTP 経由で通信するだけです。

これが存在する核となる理由: SD.Next のリクエストパラメータは A1111 とは異なります（モジュラーガイダンス、1024 のデフォルトキャンバス、組み込みの YOLO ディテーラー、独立した軸としてのスケジューラー、UNet/DiT など）。そのため、A1111 用の MCP コードは SD.Next では動作しません。ここにあるすべてのツールは、SD.Next の実際の pydantic リクエストフィールドに基づいてモデル化されています。

要件

• Node.js ≥ 18（グローバルな fetch、FormData、AbortSignal.timeout を使用）

• --api --listen 付きで起動した実行中の SD.Next インスタンス（認証を有効にするには --api-auth user:pass を追加）

Related MCP server: sd-neo-mcp

インストール

cd sdnext_mcp
npm install          # installs @modelcontextprotocol/sdk + zod

実行

デフォルトは stdio トランスポートです（MCP ホストによって起動されます）:

# in your MCP host config
{
  "mcpServers": {
    "sdnext": {
      "command": "node",
      "args": ["/abs/path/to/sdnext_mcp/src/index.js"],
      "env": {
        "SDNEXT_BASE_URL": "http://127.0.0.1:7860",
        "SDNEXT_USERNAME": "user",
        "SDNEXT_PASSWORD": "pass"
      }
    }
  }
}

または、Streamable HTTP トランスポートを直接実行します:

SDNEXT_MCP_TRANSPORT=http SDNEXT_MCP_PORT=8787 node src/index.js
# → http://127.0.0.1:8787/mcp

設定（環境変数）

ツールファミリー（合計 125 個）

• 生成 — sdnext_txt2img、sdnext_img2img、sdnext_control、sdnext_process_image、sdnext_process_batch、sdnext_detail、sdnext_prompt_enhance

• 列挙子 — sdnext_list_samplers … sdnext_list_masking（29 個のリストツール）

• 画像理解 — sdnext_caption、sdnext_caption_dispatch、sdnext_tagger、sdnext_vqa、sdnext_analyze

• モデル/オプション — チェックポイント、VAE、UNet、LoRA の更新/選択/読み込み、sdnext_get_options/sdnext_set_options

• サーバー — sdnext_status、sdnext_progress、中断/スキップ、再起動/シャットダウン、ログ、履歴、ストレージ、GPU

• ファイル/ギャラリー — sdnext_upload、sdnext_file、delete-、browser/、sdnext_png_info

• コントロール処理 — sdnext_preprocess、sdnext_mask、sdnext_detect

• モデレーション — sdnext_nudenet、sdnext_prompt_lang、sdnext_image_guard、sdnext_prompt_banned

• CivitAI — 検索、モデル/バージョン、ダウンロードキュー、設定、ブックマーク、禁止、履歴（27 個のツール）

• メタ — sdnext_list_tools、sdnext_call_api（汎用パススルー）、オートコンプリートファイル管理

実行時に sdnext_list_tools を実行して完全なカタログを確認するか、node scripts/dump_tools.mjs を実行してください。

典型的なワークフロー

sdnext_list_checkpoints   → pick a model
sdnext_list_samplers      → pick a sampler
sdnext_txt2img { prompt, sd_model_checkpoint, sampler_name, width:1024, height:1024, steps:20 }
sdnext_progress           → poll while it runs
sdnext_caption / sdnext_tagger → understand a result

画像は入出力ともに生の base64 PNG です（data: プレフィックスなし）。画像が入力となる場所では "upload:<id>" 参照が受け入れられます。任意の生成ツールで save_dir を渡すと、結果をディスクにも書き込めます。

スクリプト

npm run check          # syntax-check the entry
node scripts/smoke.mjs # DRY_RUN stdio smoke test (no live server needed)
node scripts/dump_tools.mjs  # export the tool catalog

レイアウト

アーキテクチャのドキュメントについては ../framework/ を参照してください（API の事実は 01-sdnext-api/、設計上の決定は 02-mcp-design/）。ソースは src/ 配下にあります: config.js、client.js、image.js、registry.js、index.js、および tools/（ドメインごとに 1 ファイル）。