Comfyui Mcp
Wraps ComfyUI's image generation API so you can create images from natural language in any MCP client. Exposes tools for txt2img, img2img refinement, variations, upscaling, ControlNet conditioning, and IP-Adapter style transfer. Runs as a streamable HTTP server by default (works with Claude Code, MetaMCP) or switches to stdio for Claude Desktop. Includes a workflow template registry that lets you save complex ComfyUI node graphs once and invoke them by name later. The image proxy endpoint is handy when clients can reach this server but not ComfyUI directly. Configure with your ComfyUI instance URL and checkpoint directory, then call generate_image or pass full workflow JSON for custom pipelines.
- tools
- 14
- transport
- HTTP
- env vars
- 3
- last updated
- Apr 20, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
generate_imageGenerate an image from a text prompt using ComfyUI's default txt2img workflow.
Generate an image from a text prompt using ComfyUI's default txt2img workflow.
No parameter schema in public metadata yet.
generate_variationsGenerate multiple variations of the same prompt by varying the seed. Returns all images at once.
Generate multiple variations of the same prompt by varying the seed. Returns all images at once.
No parameter schema in public metadata yet.
generate_with_workflowSubmit an arbitrary ComfyUI workflow JSON (full node graph) and return the resulting image URLs.
Submit an arbitrary ComfyUI workflow JSON (full node graph) and return the resulting image URLs.
No parameter schema in public metadata yet.
refine_imageRun img2img on a source image. The server fetches a source URL, uploads it to ComfyUI, and runs a denoising pass guided by a new prompt.
Run img2img on a source image. The server fetches a source URL, uploads it to ComfyUI, and runs a denoising pass guided by a new prompt.
No parameter schema in public metadata yet.
list_modelsList available checkpoints, LoRAs, samplers, or schedulers on the ComfyUI instance.
List available checkpoints, LoRAs, samplers, or schedulers on the ComfyUI instance.
No parameter schema in public metadata yet.
list_workflowsList built-in workflow templates shipped with this server (currently txt2img, img2img, upscale, controlnet, ip_adapter).
List built-in workflow templates shipped with this server (currently txt2img, img2img, upscale, controlnet, ip_adapter).
No parameter schema in public metadata yet.
upload_imageUpload a reference image to ComfyUI for use in img2img, ControlNet, or IP-Adapter workflows.
Upload a reference image to ComfyUI for use in img2img, ControlNet, or IP-Adapter workflows.
No parameter schema in public metadata yet.
generate_with_controlnetGenerate an image conditioned by a ControlNet preprocessed image (pose skeleton, depth map, canny edges, normal map, etc.) plus a text prompt.
Generate an image conditioned by a ControlNet preprocessed image (pose skeleton, depth map, canny edges, normal map, etc.) plus a text prompt.
No parameter schema in public metadata yet.
generate_with_ip_adapterGenerate an image using a reference image as a visual/style/subject guide via IP-Adapter.
Generate an image using a reference image as a visual/style/subject guide via IP-Adapter.
No parameter schema in public metadata yet.
save_workflow_templateSave a workflow JSON under a named slot. overwrite=true to replace.
Save a workflow JSON under a named slot. overwrite=true to replace.
No parameter schema in public metadata yet.
list_workflow_templatesList saved templates with descriptions and last-updated timestamp.
List saved templates with descriptions and last-updated timestamp.
No parameter schema in public metadata yet.
get_workflow_templateFetch a stored template's JSON plus metadata.
Fetch a stored template's JSON plus metadata.
No parameter schema in public metadata yet.
delete_workflow_templateDelete a stored template.
Delete a stored template.
No parameter schema in public metadata yet.
run_workflow_templateRun a saved template against ComfyUI and return image URLs.
Run a saved template against ComfyUI and return image URLs.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
COMFYUI_URLComfyUI HTTP URL used internally by this server. Default: http://127.0.0.1:8188
COMFYUI_PUBLIC_URLExternally-reachable ComfyUI URL used in image URLs returned to clients. Set when the internal URL isn't reachable from MCP clients (common with Docker networks).
COMFYUI_DEFAULT_CKPTDefault checkpoint filename. Default: sd_xl_base_1.0.safetensors
Readme
comfyui-mcp
MCP server for ComfyUI. Generate images from natural language prompts in any MCP-compatible client.
Status
v0.2 ships the core tools plus upscale, an image proxy, and public-URL support. Current tool surface: generate_image, generate_variations, generate_with_workflow, refine_image, upscale_image, list_models, list_workflows, upload_image, generate_with_controlnet, generate_with_ip_adapter, plus a workflow template registry. See Roadmap for what's next.
Install
npx (no install required)
npx @miller-joe/comfyui-mcp --comfyui-url http://your-comfyui-host:8188
npm
npm install -g @miller-joe/comfyui-mcp
comfyui-mcp --comfyui-url http://your-comfyui-host:8188
Details
- Repository
- github.com/miller-joe/comfyui-mcp
- Package
@miller-joe/comfyui-mcp- Transport
- HTTP
- Registry
- MCP registry, active