comfy-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COMFYUI_URL | No | URL of your ComfyUI server. Can also be set in the config file under comfyui_url. | http://127.0.0.1:8188 |
| COMFY_MCP_CONFIG | No | Path to the TOML configuration file. Overrides the default ~/.config/comfy-mcp/config.toml. Can also be set with --config PATH. | ~/.config/comfy-mcp/config.toml |
| COMFY_MCP_HTTP_TOKEN | No | Bearer token for Streamable HTTP mode. Required when running with --http; must be at least 16 characters. | |
| COMFY_MCP_OUTPUT_DIR | No | Directory where generated images are saved. Can also be set in the config file under output_dir. | ~/Pictures/ComfyUI |
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 | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generate new image(s) from a text prompt. |
| edit_imageA | Edit one image, or compose a new image from 2-4 reference images. |
| server_statusA | Check the ComfyUI server: reachability, version, GPU memory, queue length and whether someone else's job is running (this MCP always queues behind it). |
| list_modelsA | List the image models this server can drive (keys for the |
| job_statusA | Peek at a job returned by generate_image/edit_image without waiting. |
| wait_for_jobA | Block up to |
| fetch_resultA | Return the images of a finished job (preview + saved path). Fails if the job is not done yet. |
| cancel_jobA | Cancel one of this server's own jobs: removes it from the ComfyUI queue or interrupts it if running. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| image_prompt_guidance | How to write prompts and edit instructions for the available image models |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| models | Live model inventory from ComfyUI |
TDQS
Scored across 8 tools
Each tool targets a distinct concern: generation, editing, server/model inspection, and job lifecycle management. The job-related tools (status, wait, fetch, cancel) are clearly differentiated by their blocking behavior and return payload.
Most tools follow a clear verb_noun pattern: generate_image, edit_image, list_models, fetch_result, cancel_job. The two status tools (server_status, job_status) are noun-first, which is a minor deviation but still readable and internally consistent.
Eight tools is well-scoped for an image generation/editing server with asynchronous job support. Each tool serves a clear purpose without redundancy or bloat.
The surface covers the full generation/edit workflow plus model discovery, server health, and complete job lifecycle management (status, wait, fetch, cancel). No critical operations are missing for the stated domain.