comfy-design-plugin

Comfy Design

Plugin marketplaces

This plugin belongs to AIGC content creation.

Category · Marketplace · Purpose Full-stack development · Full Stack Plugins · Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations AIGC content creation · Full AIGC Plugins · Image, video, audio, music, 3D, and multimodal content creation

Generate images, video, audio and 3D on your own GPU through a local ComfyUI MCP, and escalate to Comfy Cloud only for partner models, registry search and uploads.

English | 简体中文 · Install · Quick start · Skills · MCP tools · Troubleshooting

Positioning

comfy-design connects a coding agent to a ComfyUI instance you run yourself. Local generation is free, prompts and artifacts stay on your machine, and the hosted Comfy MCP is an opt-in escalation for the cloud-only surface. The plugin never starts ComfyUI for you, never silently switches to a paid path, and never retries a submission whose result is unknown.

The content bodies are vendored from Comfy-Org/comfy-skills (MIT) and the local MCP server from MetaBrain-Labs/ComfyUI-MCP-Server-Python (MIT) with documented patches. Vendored text is unmodified; only host packaging is added.

Installation

Prerequisites

• Python 3.10 or newer for the vendored MCP runtime.
• A running ComfyUI service, by default at 127.0.0.1:8188. A LAN host is supported through COMFY_UI_SERVER_IP/HOST/PORT in vendor/comfyui-mcp-server/.env.
• Optional: a comfyui- prefixed Comfy Cloud API key, only for the cloud escalation path.
• A GPU with enough VRAM for the models you intend to run; model files are not bundled.

One-time local setup

python3 scripts/setup_comfy_mcp.py        # create the vendored venv and install locked deps
python3 scripts/comfy_local_setup.py check # read-only status: venv, target reachability, cloud key

The host actually launches scripts/comfy_mcp_bootstrap.py, which preflights the venv, generates .env on first use, checks that the target ComfyUI answers, and only then hands stdio to the vendored server.

From the plugin marketplace

codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add comfy-design@full-aigc-plugins

Restart the host and open a new task. If the local server cannot start, the bootstrap prints one actionable diagnostic instead of command not found.

Quick start

flowchart LR
    A[Request] --> B[Local comfy-mcp by default]
    B --> C{Local capability?}
    C -->|yes| D[Queue prompt on your GPU]
    C -->|no| E[Explain cost and ask]
    E --> F[comfy-cloud escalation]
    D --> G[Save assets locally]
    F --> H[Download signed URL, verify locally]
    G --> I[Verified local artifact]
    H --> I

Generate an image of a ceramic teapot on a linen table with soft morning light,
using my local ComfyUI. Show the workflow you picked and save the result to my output folder.

Expected observation: get_system_status confirms the service and VRAM, the workflow is queued locally, and the artifact lands in the directory you named. No credits are consumed.

What you can build

Workflow · Built-in path · Verifiable output Text-to-image and edits · comfy-generate-image, comfy-design-loop · Local image files plus the workflow used Video generation · comfy-generate-video · Local video artifact Audio and 3D · comfy-generate-audio, comfy-generate-3d · Local audio or mesh artifact Utility passes · comfy-upscale-image, comfy-remove-background, technique-combine-people · Processed image files Discover what is installed · comfy-search-models, comfy-search-nodes, comfy-search-templates, comfy-help · Model, node and workflow inventories

Skills

Skill · What it does comfy-generate-image · Generates, edits or modifies an image through Comfy. comfy-generate-video · Generates, edits or extends a video through Comfy. comfy-generate-audio · Generates speech or sound effects through Comfy. comfy-generate-3d · Generates a 3D model through Comfy. comfy-upscale-image · Upscales an image. comfy-remove-background · Removes an image background. technique-combine-people · Composites the user's photo with another person into one image. comfy-search-models · Searches available models. comfy-search-nodes · Searches nodes with wiring hints. comfy-search-templates · Finds pre-built workflow templates. comfy-help · Explains what the Comfy tool surface can do. comfy-local-setup · Configures the target host, the optional cloud key and the local runtime. comfy-harness · Invocation spec: local-first routing, cloud-to-local tool mapping, cost gates and submit-once. comfy-design-loop · Multi-round quality loop against an anchored target image with an independent rubric review.

Slash commands

Command · What it does /comfy-generate-image · Generate, edit or modify an image. /comfy-generate-video · Generate, edit or extend a video. /comfy-generate-audio · Generate audio. /comfy-generate-3d · Generate a 3D model. /comfy-upscale-image · Upscale an image. /comfy-remove-background · Remove an image background. /comfy-combine-people · Composite multiple people into one image. /comfy-search-models · Search the model catalog. /comfy-search-nodes · Search nodes with wiring hints. /comfy-search-templates · Find workflow templates. /comfy-help · Show what the tool surface can do. /comfy-local-setup · Configure the target host, cloud key and runtime self-check.

MCP tools

mcp.json declares two servers: comfy-mcp (stdio, your machine, default) and comfy-cloud (hosted HTTPS, escalation only).

Server · Real tools (selection) · Notes comfy-mcp · get_system_status, list_models, get_workflows_catalog, mount_workflow, queue_prompt, get_prompt_result, save_task_assets, interrupt_prompt · 17 local tools in total, including queue_custom_prompt, save_custom_workflow, upload_assets, free_memory and list_local_templates comfy-cloud · search_models, search_nodes, search_templates, submit_workflow, get_job_status, get_output, upload_file, run_template, partner_generate · Requires a comfyui- API key or OAuth; generation is billed

Local generation writes files directly. The cloud path returns a signed URL and a ready-to-run curl; execute it verbatim, then verify the downloaded file locally.

Configuration

Setting · Location · Notes ComfyUI target · vendor/comfyui-mcp-server/.env · COMFY_UI_SERVER_IP/HOST/PORT, default 127.0.0.1:8188 Local setup form · python3 scripts/comfy_local_setup.py ui · http://127.0.0.1:8192; writes the target and a restricted user config Cloud API key · Host secret store or COMFY_API_KEY · Optional; never commit it and never paste it into chat Vendored venv · vendor/comfyui-mcp-server/.venv · Created by scripts/setup_comfy_mcp.py

Architecture and security

The plugin owns host adapters, configuration injection, scripts and its two local Skills. ComfyUI owns rendering; Comfy-Org owns the vendored content; the authors receive no prompt or artifact.

• The default path is local, so prompts and outputs leave neither the machine nor the LAN target you configured.
• The optional HTTP transport has no authentication and binds 127.0.0.1 only; exposing it requires your own authenticated gateway.
• Cloud escalation is announced with its cost before it happens; named partner models exist only in the cloud.
• A submitted prompt_id is persisted before polling. Unknown or failed results are reported, never automatically resubmitted.

Troubleshooting

Symptom · Check first · Resolution Local MCP does not start · Bootstrap stderr preflight · Missing venv → python3 scripts/setup_comfy_mcp.py Target unreachable · ComfyUI process and .env · Start ComfyUI first; the plugin will not launch it A named model is refused locally · Local model inventory · That model is cloud partner-only; approve the escalation or pick a local model Cloud calls fail · API key and subscription · Use codex mcp login comfy-cloud or a comfyui- key with credits Workflow catalog is empty · Background scan still running · Wait, or submit API JSON through queue_custom_prompt A long job blocks · Sync/async choice · Short jobs stay synchronous; video and upscale need is_async: "true"

Upgrade

codex plugin marketplace upgrade full-aigc-plugins
codex plugin add comfy-design@full-aigc-plugins

After upgrading, re-run python3 scripts/comfy_local_setup.py check and the vendored skill check, because the pinned upstream revision and the MCP patch set are versioned with the plugin.

Current packaged version: 0.6.1+codex.20261018 (development preview).

Contributing and support

Open functional issues at . State the ComfyUI version, the target host shape (local or LAN) and whether the change touches the vendored server or only the adapter. Do not edit vendored bodies directly.

License

Apache-2.0 for the adapter code. Vendored skill and command content is MIT from Comfy-Org — see NOTICE, upstream/comfy-skills.lock.json and vendor/comfyui-mcp-server/PATCHES.md.