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
JavaScript
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