>sdcraft-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SDCRAFT_CONFIG | No | Overrides the path to the sdcraft.config.json configuration file (the main file is sdcraft.config.json by default). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_statusB | sd-server state: running, managed, profile/model, port, uptime, queue. |
| start_serverB | Start sd-server (optionally with the given profile). Lazy autostart also happens on demand. |
| stop_serverA | Stop sd-server (frees VRAM/RAM). Stops only the instance started by this MCP. |
| restart_serverB | Force-restart sd-server (stop+start). Optionally on another profile. |
| set_profileB | Set the active profile (model) — restarts the server if it is running. |
| list_profilesB | List profiles: model, defaults, supported operations. |
| capabilitiesB | Live server capabilities: model, samplers/schedulers, defaults, limits, upscale availability. |
| generate_imageB | Asynchronous prompt generation. Waits up to wait_seconds (default 20, capped at ~30s); if done returns the PNG path, otherwise a job_id for get_job. |
| edit_imageB | Edit/transform an image: init_image (img2img/inpaint) or ref_images (edit). Asynchronous, like generate_image (waits <= ~30s, otherwise job_id). |
| upscale_imageB | Upscale an image via RGB ESRGAN (requires an upscale model configured on the server). |
| get_jobA | Job status/progress/result (waits <= ~30s). Saves the PNG on completion. Does NOT start the server. |
| cancel_jobB | Cancel a job (queued or running). Does NOT start the server. |
| list_jobsC | Jobs known to this MCP in this session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Generation verbs (generate/edit/upscale) and job tools (get/cancel/list) are clearly distinct. The only mild overlaps are capabilities vs list_profiles vs server_status, and start vs restart, but descriptions resolve them.
Most tools follow verb_noun (stop_server, get_job, generate_image, set_profile), with a few noun-first outliers (server_status, capabilities) and inconsistent verb+object for upscale_image vs edit_image. Readable and mostly predictable.
13 tools is well-scoped for a local SD server wrapper, covering lifecycle, jobs, and generation without redundancy. Each tool earns its place.
Covers server lifecycle, profiles, capabilities, job management, and image generation/editing/upscaling. Minor gaps like job cleanup/deletion or explicit model listing beyond profiles, but core workflows are complete.