Skip to main content
Glama

comfyops-mcp — Local Generative AI Engine

Wraps ComfyUI so you can generate images, video, and upscales from a prompt — without ever touching the node editor. Pick a curated workflow, type what you want, get a PNG or MP4.

FastMCP 3.4+ | 5 portmanteau tools | 27 curated workflows | ComfyUI :11086 | Backend :11087 | Dashboard :11088

Comfy for the Perplexed

What's ComfyUI? It's the engine room of local AI image generation. You connect boxes labelled "KSampler", "CLIP Text Encode", and "VAE Decode" with wires, like a Moog synthesizer made by someone who hates knobs. It's incredibly powerful and completely impenetrable.

What's this? comfyops-mcp is a butler for ComfyUI. You tell it what you want — "a cat surfing on a pizza slice" — and it picks the right boxes, wires them up, and hands you the result. No node editor, no patch cables, no "what's a CFG scale?"

What can it do?

  • Turn text into images — verified: FLUX.2 klein 4B (seed-reproducible) and SD 1.5; curated: SDXL, FLUX.1 family, Z-Image, PixArt, Lumina2

  • Turn text or photos into short videos — curated (Wan 2.1/2.2, Hunyuan, LTX, Mochi, Cosmos) — not yet end-to-end verified

  • Upscale / restore old images — curated (ESRGAN, SUPIR) — not yet end-to-end verified

  • Inpaint and edit (SD1.5 inpaint/img2img; FLUX fill curated)

  • Browse and catalog workflows from the community

  • Remember every generation with its seed so you can reproduce it later

Who is it for?

  • You, who just wants pictures — prompt in, PNG out

  • You, who has an RTX 4090 gathering dust — put it to work

  • You, who already uses ComfyUI — now your AI assistant can drive it

  • You, who saw a cool AI image online and wants to make one

If you already know ComfyUI: comfyops registers curated workflows from workflows/ as MCP tools. You can add your own with comfy_workflows/register. The workflows dir is yours — export from the node editor, drop in, done.

Related MCP server: comfyui-mcp

Preview

ComfyUI Node Editor (what we wrap)

comfyops Dashboard (what you see)

ComfyUI

Dashboard

Screenshots pending — run just screenshots once the dashboard is live.

What You Can Do

"Generate a 1024x1024 image of a cat surfing on a pizza slice"
"Upscale my archive of 2024 SD generations to 4K"
"Turn this photo into a cinematic video" (Wan 2.2 i2v)
"Make 10 variations of this character concept"

Quick Install

git clone https://github.com/sandraschi/comfyops-mcp
cd comfyops-mcp
uv sync
.\start.ps1

See docs/ONBOARDING.md for first-run (ComfyUI + models), and INSTALL.md for Claude Desktop config.

Models from Civitai: use civitai-mcp to search/download into the ComfyUI models tree; this repo generates.

Features

  • Prompt-to-image — verified: FLUX.2 klein 4B fp8 (official ComfyUI wiring, ~1-2 min per 1024x1024 on a 4090, seed-reproducible) and SD 1.5

  • Prompt-to-video / upscale / inpaint: curated workflows (Wan 2.1/2.2, Hunyuan, LTX, Mochi, ESRGAN, SUPIR) — pending end-to-end verification

  • Model downloads: comfy_models/download streams from Hugging Face with optional sha256 verification and Bearer auth for gated repos

  • VRAM guard: Checks free GPU memory before queueing — no OOM crashes; models are unloaded after each run so the reading stays honest

  • Seed control: Same seed + same workflow = identical output, every time (verified)

  • Generation library & gallery: SQLite history with sorting, filters, batch delete/export (CSV/JSON), and crossconnects (same workflow/model)

  • Agentic workflow: Multi-step generation planning via MCP sampling (SEP-1577)

  • Prefab cards: Rich in-chat status and generation cards

How It Runs

Mode

ComfyUI required?

When

MCP tools (stdio/HTTP)

Yes

Generation via Claude Desktop, Cursor, opencode

Dashboard (Vite)

No

Browse workflows, models, library — generation needs ComfyUI

ComfyUI sidecar

Optional

start.ps1 can launch ComfyUI automatically if COMFYOPS_COMFYUI_DIR is set

Workflow Depot

comfyops ships with 27 curated workflows (t2i, i2v, t2v, inpaint, edit, upscale, restore). Use comfy_workflows/register to add your own exports from the ComfyUI node editor.

Tools

Tool

Ops

comfy_generate

image, video, upscale, inpaint, edit

comfy_workflows

list, get, validate, register

comfy_models

list_installed, download, check_vram, health

comfy_library

recent, search, record

comfy_agentic_assist

Multi-step via MCP sampling

Community

Related MCP Connectors

Related MCP Servers