An MCP endpoint (Streamable HTTP) inside ComfyUI's server, so Claude, Cursor, Cherry Studio and other MCP apps can ask about the user's library without anything extra installed and without memory or VRAM while nobody is connected. - api/mcp_server.py: one JSON-RPC message per POST, answered with JSON. Serves the 2026-07-28 stateless protocol (headers must match the body) and the earlier initialize-based versions; no sessions. This computer only: loopback peer, no proxy headers, loopback Host and Origin (DNS rebinding). - api/mcp_tools.py: 11 read-only tools: library overview, model search and details (optional cover), scan status, output-image search and generation settings (optional thumbnail), combos, workflow recipes, saved prompts, generated audio, activity log. Ids resolve inside their roots; tool failures come back as isError. - docs/guides/mcp.md: setup for each app, what can be asked, privacy note. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Architecture Topic Guide
Start with the repository-root ARCHITECTURE.md, then
open only the topic needed for the current task.
backend.md: Python routes, filesystem safety, persistence, scan state, model sidecars, and backend performance.frontend.md: extension bootstrap, UI ownership, localization, media lifecycle, panel state, and graph mutations.recipes.md: Workflow Recipes, packages, galleries, Parameter Notebooks, prompt roles, and recipe-to-model transitions.material-library.md: saved prompts and node values (material files), keeping an output image, and dragging prompts onto the canvas.recipe-model-lifecycle.md: authoritative model fields, Hash synchronization, local matching, partial append, and note privacy.model-resolution.md: model provenance, Model Check, hash injection, model scanning, and recovery policy.../decisions/README.md: concise records of product and architectural decisions that still explain current behavior.
These documents describe current contracts rather than implementation history.
For exact changes, use Git history. For user-visible releases, use
CHANGELOG.md. For recurring implementation traps, use
.agents/logs/ai_lessons.md.