UNPKG

comfyui-mcp

Version:

Local-first, agent-native control plane for ComfyUI — MCP server + autonomous sidebar agent that drives your live graph in natural language on ANY LLM: Claude/ChatGPT/Gemini on your subscription (no API key), free local models via Ollama (fully offline),

218 lines • 11.1 kB
import { registerWorkflowExecuteTools } from "./workflow-execute.js"; import { registerWorkflowVisualizeTools } from "./workflow-visualize.js"; import { registerWorkflowComposeTools } from "./workflow-compose.js"; import { registerWorkflowValidateTools } from "./workflow-validate.js"; import { registerQueueManagementTools } from "./queue-management.js"; import { registerBatchTools } from "./batches.js"; import { registerRegistrySearchTools } from "./registry-search.js"; import { registerModelManagementTools } from "./model-management.js"; import { registerModelExtrasTools } from "./model-extras.js"; import { registerExtraPathsTools } from "./extra-paths.js"; import { registerSkillGeneratorTools } from "./skill-generator.js"; import { registerDiagnosticsTools } from "./diagnostics.js"; import { registerRunpodTools } from "./runpod.js"; import { registerWorkflowLibraryTools } from "./workflow-library.js"; import { registerWorkflowUrlTools } from "./workflow-url.js"; import { registerProcessControlTools } from "./process-control.js"; import { registerImageManagementTools } from "./image-management.js"; import { registerMemoryManagementTools } from "./memory-management.js"; import { registerGenerationTrackerTools } from "./generation-tracker.js"; import { registerAssetTools } from "./assets.js"; import { registerAutoloadedWorkflows } from "./workflow-autoload.js"; import { registerDefaultsTools } from "./defaults.js"; import { registerGenerateImageTool } from "./generate-image.js"; import { registerGenerateAudioTool } from "./generate-audio.js"; import { registerGenerate3dTools } from "./generate-3d.js"; import { registerGenerateVideoTool } from "./generate-video.js"; import { registerRemoveBackgroundTool } from "./remove-background.js"; import { registerUpscaleImageTool } from "./upscale-image.js"; import { registerConditionedGenerationTools } from "./generate-conditioned.js"; import { registerWorkflowDslTools } from "./workflow-dsl.js"; import { registerNodeSnapshotsTools } from "./node-snapshots.js"; import { registerNodeBisectTools } from "./node-bisect.js"; import { registerNodeManagementTools } from "./node-management.js"; import { registerReportIssueTools } from "./report-issue.js"; import { registerNodeAuthoringTools } from "./node-authoring.js"; import { registerNodeVerifyTools } from "./node-verify.js"; import { registerWorkflowDepsTools } from "./workflow-deps.js"; import { registerMissingModelTools } from "./missing-models.js"; import { registerInstallComfyUITools } from "./install-comfyui.js"; import { registerUpdateComfyUITools } from "./update-comfyui.js"; import { registerWorkspaceEnvTools } from "./workspace-env.js"; import { registerApiNodesTools } from "./api-nodes.js"; import { registerManagerConfigTools } from "./manager-config.js"; import { registerManifestTools } from "./manifest.js"; import { registerModelExplorerTools } from "./model-explorer.js"; import { registerPromptDirectorTools } from "./prompt-director.js"; import { registerImageConvertTools } from "./image-convert.js"; import { registerColorAnalysisTools } from "./color-analysis.js"; import { registerStorageUploadTools } from "./storage-upload.js"; import { registerHealthCheckTools } from "./health-check.js"; import { registerWorkflowLockTools } from "./workflow-lock.js"; import { registerSkillsAccessTools } from "./skills-access.js"; import { registerInstallPanelTools } from "./install-panel.js"; import { registerSelfUpdateTools } from "./self-update.js"; import { registerCalculateTools } from "./calculate.js"; import { registerComfyUISettingsTools } from "./comfyui-settings.js"; import { registerNodeDevTools } from "./node-dev.js"; import { registerComfyCliTools } from "./comfy-cli.js"; import { registerTrainTools } from "./train.js"; import { registerAppsTools } from "./apps.js"; import { registerTemplateSchemaTools } from "./template-schema.js"; import { registerRunTemplateTools } from "./run-template.js"; import { DefaultsManager } from "../services/defaults-manager.js"; import { ToolCatalog } from "./catalog.js"; /** * Every static tool group, in registration order (order is observable in * tools/list, so it must not change), tagged with the category used by the * compact tool mode's list_tools manifest. */ const TOOL_GROUPS = [ ["comfy-cli", registerComfyCliTools], ["workflows", registerWorkflowExecuteTools], ["workflow-authoring", registerWorkflowVisualizeTools], ["workflow-authoring", registerWorkflowComposeTools], ["workflow-authoring", registerWorkflowValidateTools], ["workflows", registerQueueManagementTools], ["custom-nodes", registerRegistrySearchTools], ["models", registerModelManagementTools], ["skills-config", registerSkillGeneratorTools], ["diagnostics", registerDiagnosticsTools], ["runpod", registerRunpodTools], ["workflow-authoring", registerWorkflowLibraryTools], ["workflows", registerWorkflowUrlTools], ["server", registerProcessControlTools], ["images-assets", registerImageManagementTools], ["server", registerMemoryManagementTools], ["generation", registerGenerationTrackerTools], ["images-assets", registerAssetTools], ["skills-config", registerDefaultsTools], ["generation", registerGenerateImageTool], ["generation", registerGenerateAudioTool], ["generation", registerGenerate3dTools], ["generation", registerGenerateVideoTool], ["generation", registerRemoveBackgroundTool], ["generation", registerUpscaleImageTool], ["generation", registerConditionedGenerationTools], ["workflow-authoring", registerWorkflowDslTools], ["custom-nodes", registerNodeSnapshotsTools], ["custom-nodes", registerNodeBisectTools], ["custom-nodes", registerNodeManagementTools], ["diagnostics", registerReportIssueTools], ["workflows", registerWorkflowDepsTools], ["models", registerMissingModelTools], ["server", registerInstallComfyUITools], ["server", registerUpdateComfyUITools], ["models", registerModelExtrasTools], ["models", registerModelExplorerTools], ["workflow-authoring", registerPromptDirectorTools], ["models", registerExtraPathsTools], ["server", registerWorkspaceEnvTools], ["generation", registerApiNodesTools], ["server", registerManagerConfigTools], ["custom-nodes", registerNodeAuthoringTools], ["custom-nodes", registerNodeVerifyTools], ["models", registerManifestTools], ["images-assets", registerImageConvertTools], ["images-assets", registerColorAnalysisTools], ["images-assets", registerStorageUploadTools], ["diagnostics", registerHealthCheckTools], ["workflow-authoring", registerWorkflowLockTools], ["skills-config", registerSkillsAccessTools], ["server", registerInstallPanelTools], ["server", registerSelfUpdateTools], ["diagnostics", registerCalculateTools], ["server", registerComfyUISettingsTools], ["custom-nodes", registerNodeDevTools], ["training", registerTrainTools], ["apps", registerAppsTools], ["workflows", registerTemplateSchemaTools], ["workflows", registerRunTemplateTools], // Appended (not inserted next to queue-management) because tools/list order // is observable and must not shift for existing tools. ["workflows", registerBatchTools], ]; // ── Blind content mode (panel issue #90) ──────────────────────────────────── // When COMFYUI_MCP_BLIND=1 (set on the tool-server spawn by the orchestrator // for tabs whose panel Blind toggle is ON), NO tool may deliver image pixels // to the model. Enforced MECHANICALLY at the single registration boundary both // tool paths share — the live McpServer and the compact-mode ToolCatalog both // receive handlers wrapped here — so the guarantee holds for every current and // future image-returning tool (get_image, view_image, convert_image, color // analysis previews, ...) without per-tool opt-ins. const blindMode = () => process.env.COMFYUI_MCP_BLIND === "1"; function scrubImageBlocks(result) { if (!result || typeof result !== "object") return result; const r = result; if (!Array.isArray(r.content)) return result; let scrubbed = 0; const content = r.content.map((block) => { if (!block || block.type !== "image") return block; scrubbed++; const bytes = typeof block.data === "string" ? Math.round((block.data.length * 3) / 4) : 0; const size = bytes ? `${Math.max(1, Math.round(bytes / 1024))} KB, ` : ""; return { type: "text", text: `[Blind mode: image withheld (${size}${String(block.mimeType ?? "image")}). ` + "The user's Blind setting means you NEVER receive image pixels — work from " + "filenames/metadata, and tell the user to inspect the image themselves if it matters.]", }; }); if (!scrubbed) return result; return { ...r, content }; } /** Wrap a registrar so every tool handler enforces Blind mode on its RESULT. * Works for both the live McpServer and ToolCatalog.asRegistrar() (the compact * call_tool router) — each captures/registers the wrapped handler. */ function withBlindImageGate(server) { const orig = server.tool.bind(server); const tool = (...args) => { const handler = args[args.length - 1]; if (typeof handler === "function") { const wrapped = async (...hargs) => { const result = await handler(...hargs); return blindMode() ? scrubImageBlocks(result) : result; }; return orig(...args.slice(0, -1), wrapped); } return orig(...args); }; return new Proxy(server, { get(target, prop, receiver) { if (prop === "tool") return tool; return Reflect.get(target, prop, receiver); }, }); } export async function registerAllTools(server) { // Hydrate persisted defaults before any tool registration so subsequent // tools can consult DefaultsManager.apply() against a fully-resolved view. await DefaultsManager.load(); const gated = withBlindImageGate(server); for (const [, register] of TOOL_GROUPS) register(gated); await registerAutoloadedWorkflows(gated); } /** * Run the same registration pass against a capturing ToolCatalog instead of a * live server. Used by the compact tool mode (small/local LLMs): the catalog * backs the list_tools / describe_tool / call_tool meta-tools. */ export async function collectToolCatalog() { await DefaultsManager.load(); const catalog = new ToolCatalog(); const registrar = withBlindImageGate(catalog.asRegistrar()); for (const [category, register] of TOOL_GROUPS) { catalog.setCategory(category); register(registrar); } catalog.setCategory("saved-workflows"); await registerAutoloadedWorkflows(registrar); return catalog; } //# sourceMappingURL=index.js.map