sdnext-mcp

Model Context Protocol (MCP)-Server für die SD.Next-WebUI (Stable Diffusion Next).

Er kapselt die REST-API von SD.Next (/sdapi/v1/* + /sdapi/v2/civitai/*) als 125 MCP-Tools, sodass ein LLM-Host (Claude Desktop, DSH usw.) jedes SD.Next-Nutzungsszenario steuern kann: Text-zu-Bild, Bild-zu-Bild, steuerungsgeführte Generierung, Hochskalierung, Detailer, LoRA, Skripte, Beschriftung/Tagging/VQA, Modell- und Optionsverwaltung, Server-Introspektion, Datei/Galerie und CivitAI.

Dies ist ein schlanker HTTP-Client. Er bettet kein Python ein und startet die WebUI nicht. Sie müssen SD.Next selbst mit --api --listen ausführen; der MCP-Server kommuniziert nur über HTTP mit ihm.

Der Hauptgrund für seine Existenz: Die Anforderungsparameter von SD.Next unterscheiden sich von A1111 (modulare Führung, 1024-Standard-Canvas, integrierter YOLO-Detailer, Scheduler als eigene Achse, UNet/DiT usw.), daher funktioniert A1111-MCP-Code damit nicht. Jedes Tool hier ist an den tatsächlichen Pydantic-Anforderungsfeldern von SD.Next modelliert.

Anforderungen

• Node.js ≥ 18 (verwendet globales fetch, FormData, AbortSignal.timeout)

• Eine laufende SD.Next-Instanz, die mit --api --listen gestartet wurde (fügen Sie --api-auth user:pass hinzu, um die Authentifizierung zu aktivieren)

Related MCP server: sd-neo-mcp

Installation

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

Ausführen

Standard ist stdio-Transport (von Ihrem MCP-Host gestartet):

# 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"
      }
    }
  }
}

Oder führen Sie den Streamable-HTTP-Transport direkt aus:

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

Konfiguration (Umgebungsvariablen)

Tool-Familien (insgesamt 125)

• Generierung — sdnext_txt2img, sdnext_img2img, sdnext_control, sdnext_process_image, sdnext_process_batch, sdnext_detail, sdnext_prompt_enhance

• Aufzählungen — sdnext_list_samplers … sdnext_list_masking (29 Listentools)

• Bildverständnis — sdnext_caption, sdnext_caption_dispatch, sdnext_tagger, sdnext_vqa, sdnext_analyze

• Modelle/Optionen — Checkpoint, VAE, UNet, LoRA aktualisieren/auswählen/laden; sdnext_get_options/sdnext_set_options

• Server — sdnext_status, sdnext_progress, Unterbrechen/Überspringen, Neustart/Herunterfahren, Protokoll, Verlauf, Speicher, GPU

• Dateien/Galerie — sdnext_upload, sdnext_file, delete-, browser/, sdnext_png_info

• Steuerungsverarbeitung — sdnext_preprocess, sdnext_mask, sdnext_detect

• Moderation — sdnext_nudenet, sdnext_prompt_lang, sdnext_image_guard, sdnext_prompt_banned

• CivitAI — Suche, Modell/Variante, Download-Warteschlange, Einstellungen, Lesezeichen, gesperrte, Verlauf (27 Tools)

• Meta — sdnext_list_tools, sdnext_call_api (generischer Durchgriff), Autovervollständigungs-Dateiverwaltung

Führen Sie zur Laufzeit sdnext_list_tools für den vollständigen Katalog aus, oder node scripts/dump_tools.mjs.

Typischer Arbeitsablauf

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

Bilder sind rohe Base64-PNGs ein- und ausgehend (ohne data:-Präfix); "upload:<id>"-Verweise werden akzeptiert, wo ein Bild eine Eingabe ist. Übergeben Sie save_dir an ein beliebiges Generierungstool, um das Ergebnis auch auf die Festplatte zu schreiben.

Skripte

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

Aufbau

Siehe ../framework/ für die Architekturdokumentation (API-Fakten in 01-sdnext-api/, Designentscheidungen in 02-mcp-design/). Quellcode unter src/: config.js, client.js, image.js, registry.js, index.js und tools/ (eine Datei pro Domäne).