sdnext-mcp

Model Context Protocol (MCP) сервер для SD.Next (Stable Diffusion Next) WebUI.

Он оборачивает REST API SD.Next (/sdapi/v1/* + /sdapi/v2/civitai/*) как 125 MCP-инструментов, чтобы LLM-хост (Claude Desktop, DSH и т.д.) мог управлять всеми сценариями использования SD.Next: текст-в-изображение, изображение-в-изображение, управляемая генерация, апскейлинг, детайлер, LoRA, скрипты, каптирование/тегирование/VQA, управление моделями и опциями, интроспекция сервера, файлы/галерея и CivitAI.

Это тонкий HTTP-клиент. Он не встраивает Python и не запускает WebUI. Вы должны сами запустить SD.Next с --api --listen; MCP-сервер просто общается с ним по HTTP.

Основная причина его существования: параметры запросов SD.Next отличаются от A1111 (модульное управление, холст по умолчанию 1024, встроенный детайлер YOLO, планировщики как отдельная ось, UNet/DiT и т.д.), поэтому код MCP для A1111 не работает с ним. Каждый инструмент здесь смоделирован на основе реальных полей запросов pydantic SD.Next.

Требования

• Node.js ≥ 18 (использует глобальные fetch, FormData, AbortSignal.timeout)

• Экземпляр SD.Next, запущенный с --api --listen (добавьте --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/ (по одному файлу на домен).