convez.ai
MCP Server
artokun

comfyui-mcp-panel

artokun/comfyui-mcp-panel

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude in your ComfyUI sidebar — live graph edits over MCP, zero API keys. Pairs with the comfyui-mcp Claude Code plugin.

Instalação

$npx convez-ai artokun/comfyui-mcp-panel

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
142
Forks
31
Acompanhando
1
Saúde
42%
Último commit
há 3 semanas
Versão
v0.15.179
Issues abertas
68
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

ComfyUI MCP Panel

✅ v0.3 is live on ComfyUI-Manager & the Comfy Registry

The polished public release — native ComfyUI design system, live activity cards for every agent edit, and multi-tab support. Search comfyui-mcp-panel in ComfyUI-Manager to install, or see the docs.

Your Claude Code session, inside ComfyUI's sidebar — it sees your graph and edits it live.

Part of the comfyui-mcp project — the Claude Code plugin + MCP server for ComfyUI (88 tools, 15 AI skills). Full documentation at comfyui-mcp.artokun.io/docs.

Type "add a KSampler and wire it to my checkpoint" in the panel (or in your Claude terminal) and watch nodes appear on the canvas. Every edit is undoable with Ctrl+Z.

No API keys. No extra LLM costs. The agent is your own Claude Code (or any MCP client) session — subscription-billed, connected through the comfyui-mcp server's channels mode. The panel is just its window into your graph.

you ⇄ Claude Code ⇄ comfyui-mcp (--channels) ⇄ ws://127.0.0.1:9101 ⇄ this panel ⇄ your graph

Install

Via ComfyUI-Manager (recommended): search for comfyui-mcp-panel and install.

Via git:

cd ComfyUI/custom_nodes
git clone https://github.com/artokun/comfyui-mcp-panel

Restart ComfyUI. A new Agent tab (💬) appears in the sidebar.

Connect your Claude session

Add comfyui-mcp to Claude Code with channels mode (Node ≥ 22):

claude mcp add comfyui -- npx -y comfyui-mcp --channels

That's it. The panel auto-connects to the bridge at ws://127.0.0.1:9101 (configurable in the panel's Connection section / COMFYUI_MCP_BRIDGE_PORT). The status pill turns green when both sides are up.

Then either:

  • talk in your Claude terminal: "check panel_status, then add a CheckpointLoaderSimple to my graph" — Claude uses the panel_* tools and the edits appear live;
  • or type in the panel: messages are pushed straight into your Claude Code session as channel events — Claude sees them immediately and replies into the panel with panel_say. (Hosts without channel support can pull via panel_inbox.)

What the agent can do to your graph

MCP toolEffect
panel_statusIs the panel connected?
panel_get_graphRead the graph you're viewing — subgraphs summarized shallowly
panel_get_subgraphDrill into a subgraph node's inner graph
panel_add_nodeAdd a node by class_type
panel_remove_nodeRemove a node
panel_move_nodeMove a node to a new canvas position
panel_clearRemove every node — the whole wipe is one Ctrl+Z
panel_connect / panel_disconnectWire / unwire slots (by name or index)
panel_set_widgetChange a widget value (steps, cfg, prompts, …)
panel_canvasFit, center on a node, pan, zoom your view
panel_runQueue the open workflow (same as pressing Queue Prompt)
panel_get_errorsRead the last execution error + node validation errors
panel_save_workflowSave (Ctrl+S) or save-as/duplicate the open workflow
panel_sayPost a message into this panel's chat feed
panel_inboxDrain messages you typed into the panel

…plus the full comfyui-mcp tool surface (88 tools: queue, models, custom nodes, workflows) — the agent is the MCP client, so it has everything.

The graph-mutation surface is a fixed allowlist — the agent cannot run arbitrary JavaScript in your browser. Every mutation goes through LiteGraph's standard change tracking, so ComfyUI's native undo reverts agent edits exactly like your own.

Security notes

  • The bridge binds to 127.0.0.1 only — nothing is reachable from your LAN.
  • The panel executes a fixed command set; no eval, no DOM access for the agent.
  • No tokens or keys are stored anywhere in this pack.

Requirements

  • ComfyUI with a frontend exposing app.extensionManager.registerSidebarTab (any 2024+ release)
  • Node ≥ 22 for the MCP server (npx -y comfyui-mcp --channels)
  • An MCP client you already use: Claude Code, Claude Desktop, Cursor, …

Roadmap

  • Remote pairing via a relay (PartyKit-style room codes) for ComfyUI-on-a-server setups
  • Migration to @comfyorg/extension-api v2 when it ships (v1 call sites tagged // TODO(v2):)

License

MIT.

This pack contains only original code — no ComfyUI or LiteGraph source is copied or bundled. It interoperates with GPL-3.0 ComfyUI at runtime through its public extension API (app.registerExtension), the same pattern used by other MIT/Apache-licensed packs (Crystools, rgthree, ComfyUI-Custom-Scripts). MIT is GPL-compatible; the runtime combination on your machine is yours.

Ver o original no GitHub

Bom para

Relacionados