comfyui-mcp 0.23.4 → 0.24.0

package/dist/tools/index.js

@@ -47,57 +47,84 @@ import { registerSkillsAccessTools } from "./skills-access.js";
 import { registerInstallPanelTools } from "./install-panel.js";
 import { registerSelfUpdateTools } from "./self-update.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 = [
+    ["workflows", registerWorkflowExecuteTools],
+    ["workflow-authoring", registerWorkflowVisualizeTools],
+    ["workflow-authoring", registerWorkflowComposeTools],
+    ["workflow-authoring", registerWorkflowValidateTools],
+    ["workflows", registerQueueManagementTools],
+    ["custom-nodes", registerRegistrySearchTools],
+    ["models", registerModelManagementTools],
+    ["skills-config", registerSkillGeneratorTools],
+    ["diagnostics", registerDiagnosticsTools],
+    ["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", registerGenerateVideoTool],
+    ["generation", registerRemoveBackgroundTool],
+    ["generation", registerUpscaleImageTool],
+    ["generation", registerConditionedGenerationTools],
+    ["workflow-authoring", registerWorkflowDslTools],
+    ["custom-nodes", registerNodeSnapshotsTools],
+    ["custom-nodes", registerNodeBisectTools],
+    ["custom-nodes", registerNodeManagementTools],
+    ["diagnostics", registerReportIssueTools],
+    ["workflows", registerWorkflowDepsTools],
+    ["server", registerInstallComfyUITools],
+    ["server", registerUpdateComfyUITools],
+    ["models", registerModelExtrasTools],
+    ["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],
+];
 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();
-    registerWorkflowExecuteTools(server);
-    registerWorkflowVisualizeTools(server);
-    registerWorkflowComposeTools(server);
-    registerWorkflowValidateTools(server);
-    registerQueueManagementTools(server);
-    registerRegistrySearchTools(server);
-    registerModelManagementTools(server);
-    registerSkillGeneratorTools(server);
-    registerDiagnosticsTools(server);
-    registerWorkflowLibraryTools(server);
-    registerWorkflowUrlTools(server);
-    registerProcessControlTools(server);
-    registerImageManagementTools(server);
-    registerMemoryManagementTools(server);
-    registerGenerationTrackerTools(server);
-    registerAssetTools(server);
-    registerDefaultsTools(server);
-    registerGenerateImageTool(server);
-    registerGenerateAudioTool(server);
-    registerGenerateVideoTool(server);
-    registerRemoveBackgroundTool(server);
-    registerUpscaleImageTool(server);
-    registerConditionedGenerationTools(server);
-    registerWorkflowDslTools(server);
-    registerNodeSnapshotsTools(server);
-    registerNodeBisectTools(server);
-    registerNodeManagementTools(server);
-    registerReportIssueTools(server);
-    registerWorkflowDepsTools(server);
-    registerInstallComfyUITools(server);
-    registerUpdateComfyUITools(server);
-    registerModelExtrasTools(server);
-    registerExtraPathsTools(server);
-    registerWorkspaceEnvTools(server);
-    registerApiNodesTools(server);
-    registerManagerConfigTools(server);
-    registerNodeAuthoringTools(server);
-    registerNodeVerifyTools(server);
-    registerManifestTools(server);
-    registerImageConvertTools(server);
-    registerColorAnalysisTools(server);
-    registerStorageUploadTools(server);
-    registerHealthCheckTools(server);
-    registerWorkflowLockTools(server);
-    registerSkillsAccessTools(server);
-    registerInstallPanelTools(server);
-    registerSelfUpdateTools(server);
+    for (const [, register] of TOOL_GROUPS)
+        register(server);
     await registerAutoloadedWorkflows(server);
 }
+/**
+ * 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 = 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

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/transport/cli.js

@@ -11,6 +11,7 @@ const DEFAULT_PORT = 9100;
 export function parseCliArgs(argv, env = process.env) {
     const args = argv.slice(2);
     let transport = env.MCP_TRANSPORT === "http" ? "http" : "stdio";
+    let toolMode = env.COMFYUI_MCP_TOOL_MODE === "compact" ? "compact" : "full";
     let host = env.MCP_HOST ?? DEFAULT_HOST;
     let port = env.MCP_PORT ? Number(env.MCP_PORT) : DEFAULT_PORT;
     let panelOrchestrator = env.COMFYUI_MCP_PANEL_ORCHESTRATOR === "1" ||
@@ -20,6 +21,9 @@ export function parseCliArgs(argv, env = process.env) {
     let allowUnauthenticated = env.COMFYUI_MCP_ALLOW_UNAUTH === "1" || env.COMFYUI_MCP_ALLOW_UNAUTH === "true";
     let insecureBridge = env.COMFYUI_MCP_INSECURE_BRIDGE === "1" || env.COMFYUI_MCP_INSECURE_BRIDGE === "true";
     let comfyuiUrl;
+    let setupAgent;
+    let setupDryRun = false;
+    let toolModeExplicit = env.COMFYUI_MCP_TOOL_MODE === "compact";
     const valueOf = (current, inline, i) => {
         if (current.includes("="))
             return [current.slice(current.indexOf("=") + 1), i];
@@ -81,6 +85,43 @@ export function parseCliArgs(argv, env = process.env) {
         else if (a === "--insecure-bridge") {
             insecureBridge = true;
         }
+        else if (a === "--compact") {
+            toolMode = "compact";
+            toolModeExplicit = true;
+        }
+        else if (a === "--full") {
+            toolMode = "full";
+            toolModeExplicit = true;
+        }
+        else if (a === "--tool-mode" || a.startsWith("--tool-mode=")) {
+            const [v, ni] = valueOf(a, "--tool-mode", i);
+            toolMode = v === "compact" ? "compact" : "full";
+            toolModeExplicit = true;
+            i = ni;
+        }
+        else if (a === "setup") {
+            // `comfyui-mcp setup <agent>` — write the comfyui MCP entry into a
+            // non-Claude harness's config (hermes | openclaw | copilot) and exit.
+            const next = args[i + 1];
+            if (next && !next.startsWith("-")) {
+                setupAgent = next;
+                i += 1;
+            }
+            else {
+                setupAgent = ""; // present but missing the agent → index.ts prints usage
+            }
+        }
+        else if (a === "--dry-run") {
+            setupDryRun = true;
+        }
+        else if (a === "--comfyui-url" || a.startsWith("--comfyui-url=")) {
+            // Also parsed by config.ts for the server itself; captured here so
+            // `setup` can embed it into the generated harness config.
+            const [v, ni] = valueOf(a, "--comfyui-url", i);
+            if (v)
+                comfyuiUrl = v;
+            i = ni;
+        }
     }
     // --tunnel implies the HTTP transport: a cloudflared quick tunnel needs an
     // HTTP origin to point at. (Token auto-generation happens at startup, not
@@ -89,6 +130,8 @@ export function parseCliArgs(argv, env = process.env) {
         transport = "http";
     return {
         transport,
+        toolMode,
+        toolModeExplicit,
         host,
         port,
         panelOrchestrator,
@@ -97,6 +140,8 @@ export function parseCliArgs(argv, env = process.env) {
         allowUnauthenticated,
         comfyuiUrl,
         insecureBridge,
+        setupAgent,
+        setupDryRun,
     };
 }
 /**

package/dist/transport/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/transport/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/transport/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "comfyui-mcp",
-  "version": "0.23.4",
+  "version": "0.24.0",
   "mcpName": "io.github.artokun/comfyui-mcp",
-  "description": "Local-first, agent-native control plane for ComfyUI — MCP server + autonomous AI agent that drives your live graph in natural language from a sidebar agent on Claude OR ChatGPT (your own subscription, no API key). Generate images, video & audio, author and run workflows, manage models and custom nodes. Also a Claude Code plugin with skills, slash commands, and installer packs. Local, LAN, VPS, or Comfy Cloud.",
+  "description": "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), or any hosted model via an OpenAI-compatible endpoint (DeepSeek, GLM, MiMo, OpenRouter). Generate images, video & audio, author and run workflows, manage models and custom nodes; a compact tool-router mode keeps even 4B models effective, and a built-in LLM Arena benchmarks them on real ComfyUI tasks. Also a Claude Code plugin with skills, slash commands, and installer packs. Local, LAN, VPS, or Comfy Cloud.",
   "homepage": "https://comfyui-mcp.artokun.io/docs",
   "type": "module",
   "main": "dist/index.js",
@@ -28,6 +28,9 @@
     "test:watch": "vitest",
     "test:integration": "cross-env COMFYUI_INTEGRATION=true vitest run",
     "test:agent": "npm run build && node scripts/test-agent.mjs",
+    "test:local-llm": "npm run build && node scripts/test-local-llm.mjs",
+    "arena": "npm run build && node scripts/llm-arena.mjs",
+    "smoke:panel": "npm run build && node scripts/panel-smoke.mjs",
     "lint": "tsc --noEmit",
     "docs:gen": "cross-env COMFYUI_URL=http://127.0.0.1:8188 tsx scripts/gen-tool-docs.ts",
     "packs:gen": "node scripts/gen-pack-installers.mjs",

package/scripts/arena-bestof.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+// Fold extra arena run dirs into the main results as BEST-OF-N per model.
+//
+//   node scripts/arena-bestof.mjs arena-results arena-results/bo3-run2 arena-results/bo3-run3
+//
+// For every model present in an extra dir, the better run (score, then fewer
+// nudges → rounds → seconds) replaces the main entry, and runs.totals records
+// every observed total so reports can show the range (e.g. "best of 3, 19–20").
+// Regenerates arena-report.md afterward.
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const [baseDir, ...runDirs] = process.argv.slice(2);
+if (!baseDir) {
+  console.error("usage: arena-bestof.mjs <base-results-dir> [extra-run-dir...]  (no dirs = re-sort + regenerate only)");
+  process.exit(1);
+}
+
+const nudgesOf = (m) => m.results.reduce((s, r) => s + (r.nudges ?? 0), 0);
+const roundsOf = (m) => m.results.reduce((s, r) => s + (r.rounds ?? 0), 0);
+const secondsOf = (m) => m.results.reduce((s, r) => s + (r.seconds ?? 0), 0);
+const better = (a, b) =>
+  b.total - a.total || nudgesOf(a) - nudgesOf(b) || roundsOf(a) - roundsOf(b) || secondsOf(a) - secondsOf(b);
+
+const basePath = join(baseDir, "arena-results.json");
+const base = JSON.parse(readFileSync(basePath, "utf8"));
+
+for (const dir of runDirs) {
+  const p = join(dir, "arena-results.json");
+  if (!existsSync(p)) {
+    console.warn(`skip ${p} (missing)`);
+    continue;
+  }
+  const extra = JSON.parse(readFileSync(p, "utf8"));
+  for (const candidate of extra.leaderboard ?? []) {
+    const i = base.leaderboard.findIndex((m) => m.model === candidate.model);
+    if (i < 0) continue;
+    const current = base.leaderboard[i];
+    const totals = [...(current.runs?.totals ?? [current.total]), candidate.total];
+    const winner = better(current, candidate) > 0 ? candidate : current;
+    base.leaderboard[i] = { ...winner, tier: current.tier, runs: { totals } };
+    console.log(`${candidate.model}: run=${candidate.total} → keeping ${winner.total} (all: ${totals.join(", ")})`);
+  }
+}
+
+// Rank: best total, then CONSISTENCY (worst run across best-of-N — a model
+// that is perfect every time outranks one that peaked once), then efficiency.
+const worstRun = (m) => Math.min(...(m.runs?.totals ?? [m.total]));
+base.leaderboard.sort(
+  (a, b) =>
+    b.total - a.total ||
+    worstRun(b) - worstRun(a) ||
+    nudgesOf(a) - nudgesOf(b) ||
+    roundsOf(a) - roundsOf(b) ||
+    secondsOf(a) - secondsOf(b),
+);
+writeFileSync(basePath, JSON.stringify(base, null, 2));
+
+// regenerate the share-ready markdown (kept in sync with llm-arena.mjs)
+const icon = { 2: "✅", 1: "🟡", 0: "❌" };
+const scen = base.scenarios ?? [];
+const md = [];
+md.push("# ComfyUI LLM Arena", "");
+md.push(
+  `Models driving a real ComfyUI (${base.gpu}) through [comfyui-mcp](https://github.com/artokun/comfyui-mcp)'s ` +
+    `compact tool mode — 6 router tools instead of ~200 schemas, so every model class can play. ` +
+    `Each model gets the identical task set; results are verified against the ComfyUI server, not the model's claims. ` +
+    `Top-cluster models are best-of-N (range shown).`,
+  "",
+);
+const header = ["Model", "Tier", ...scen.map((s) => s.id), "Score", "Nudges", "Rounds", "Time"];
+md.push(`| ${header.join(" | ")} |`, `|${header.map(() => "---").join("|")}|`);
+for (const m of base.leaderboard) {
+  const cells = m.results.map((r) => icon[r.score]);
+  const totals = m.runs?.totals;
+  const score =
+    totals && totals.length > 1
+      ? `**${m.total}/${m.max}** (best of ${totals.length}: ${Math.min(...totals)}–${Math.max(...totals)})`
+      : `**${m.total}/${m.max}**`;
+  md.push(
+    `| \`${m.model}\` | ${m.tier ?? "local"} | ${cells.join(" | ")} | ${score} | ${nudgesOf(m)} | ${roundsOf(m)} | ${secondsOf(m)}s |`,
+  );
+}
+md.push("", `Scenarios: ${scen.map((s) => `**${s.id}** (${s.title.toLowerCase()})`).join(" · ")}`, "");
+md.push(`✅ completed & server-verified · 🟡 right tool family, incomplete outcome · ❌ failed`, "");
+md.push("Reproduce: `npm run arena` — bring your own models via `ARENA_MODELS=...` (see docs/arena)");
+writeFileSync(join(baseDir, "arena-report.md"), `${md.join("\n")}\n`);
+console.log("report regenerated");

package/scripts/arena-graphic.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+// Render the LLM Arena leaderboard as share/docs-ready SVGs (light + dark).
+//
+//   node scripts/arena-graphic.mjs [path/to/arena-results.json]
+//
+// Emits arena-leaderboard-light.svg and arena-leaderboard-dark.svg next to the
+// results file. Palette validated with the dataviz six-checks (CVD ΔE ≥ 41,
+// dark-surface contrast ≥ 3:1); tier identity is never color-alone — every row
+// names its tier in ink.
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+const resultsPath = process.argv[2] ?? join(process.cwd(), "arena-results", "arena-results.json");
+const data = JSON.parse(readFileSync(resultsPath, "utf8"));
+const rows = data.leaderboard ?? [];
+const maxScore = rows[0]?.max ?? 20;
+
+const MODES = {
+  light: {
+    surface: "#fcfcfb",
+    inkPrimary: "#0b0b0b",
+    inkSecondary: "#52514e",
+    inkMuted: "#898781",
+    grid: "#e1e0d9",
+    baseline: "#c3c2b7",
+    track: "#f0efec",
+    tier: { SoTA: "#2a78d6", "B-tier": "#1baf7a", local: "#eda100" },
+  },
+  dark: {
+    surface: "#1a1a19",
+    inkPrimary: "#ffffff",
+    inkSecondary: "#c3c2b7",
+    inkMuted: "#898781",
+    grid: "#2c2c2a",
+    baseline: "#383835",
+    track: "#232322",
+    tier: { SoTA: "#3987e5", "B-tier": "#199e70", local: "#c98500" },
+  },
+};
+
+const FONT = `system-ui, -apple-system, 'Segoe UI', sans-serif`;
+const W = 860;
+const PAD = 28;
+const HEADER_H = 92;
+const ROW_H = 34;
+const BAR_H = 14;
+const LABEL_W = 250; // model name + tier text
+const VALUE_W = 90; // right column: score (+ range)
+const FOOTER_H = 64;
+const plotW = W - PAD * 2 - LABEL_W - VALUE_W;
+
+const esc = (s) => String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+
+function render(mode) {
+  const c = MODES[mode];
+  const H = HEADER_H + rows.length * ROW_H + FOOTER_H;
+  const plotX = PAD + LABEL_W;
+  const parts = [];
+  parts.push(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="0 0 ${W} ${H}" font-family="${FONT}">`,
+    `<rect width="${W}" height="${H}" rx="12" fill="${c.surface}"/>`,
+    `<text x="${PAD}" y="${PAD + 10}" font-size="19" font-weight="700" fill="${c.inkPrimary}">ComfyUI LLM Arena</text>`,
+    `<text x="${PAD}" y="${PAD + 32}" font-size="12.5" fill="${c.inkSecondary}">${rows.length} models · ${data.scenarios?.length ?? 10} real ComfyUI tasks over MCP · every score verified against the server, not the model's claims</text>`,
+  );
+  // legend (tier chips + names)
+  let lx = PAD;
+  for (const [tier, color] of Object.entries(c.tier)) {
+    parts.push(
+      `<rect x="${lx}" y="${PAD + 44}" width="10" height="10" rx="2" fill="${color}"/>`,
+      `<text x="${lx + 15}" y="${PAD + 53}" font-size="11.5" fill="${c.inkSecondary}">${tier}</text>`,
+    );
+    lx += 15 + tier.length * 6.6 + 22;
+  }
+  // gridlines + scale ticks
+  for (const tick of [0, 5, 10, 15, 20]) {
+    const x = plotX + (tick / maxScore) * plotW;
+    parts.push(
+      `<line x1="${x}" y1="${HEADER_H - 6}" x2="${x}" y2="${HEADER_H + rows.length * ROW_H}" stroke="${tick === 0 ? c.baseline : c.grid}" stroke-width="1"/>`,
+      `<text x="${x}" y="${HEADER_H + rows.length * ROW_H + 16}" font-size="10.5" fill="${c.inkMuted}" text-anchor="middle" font-variant-numeric="tabular-nums">${tick}</text>`,
+    );
+  }
+  // rows
+  rows.forEach((m, i) => {
+    const y = HEADER_H + i * ROW_H;
+    const cy = y + ROW_H / 2;
+    const color = c.tier[m.tier] ?? c.inkMuted;
+    const w = Math.max(2, (m.total / m.max) * plotW);
+    const runs = m.runs?.totals;
+    const range = runs && runs.length > 1 ? `${Math.min(...runs)}–${Math.max(...runs)}` : null;
+    const name = m.model.length > 34 ? `${m.model.slice(0, 33)}…` : m.model;
+    parts.push(
+      `<text x="${PAD}" y="${cy - 1}" font-size="12.5" font-weight="600" fill="${c.inkPrimary}">${esc(name)}</text>`,
+      `<text x="${PAD}" y="${cy + 12}" font-size="10" fill="${c.inkSecondary}">${esc(m.tier ?? "local")}</text>`,
+      // track + bar: thin mark, 4px rounded DATA end only (square baseline end)
+      `<rect x="${plotX}" y="${cy - BAR_H / 2}" width="${plotW}" height="${BAR_H}" fill="${c.track}"/>`,
+      `<path d="M ${plotX} ${cy - BAR_H / 2} H ${plotX + w - 4} a 4 4 0 0 1 4 4 v ${BAR_H - 8} a 4 4 0 0 1 -4 4 H ${plotX} Z" fill="${color}"/>`,
+      `<text x="${plotX + plotW + 12}" y="${cy + 4}" font-size="13" font-weight="700" fill="${c.inkPrimary}" font-variant-numeric="tabular-nums">${m.total}/${m.max}</text>`,
+    );
+    if (range) {
+      parts.push(
+        `<text x="${plotX + plotW + 12}" y="${cy + 16}" font-size="9.5" fill="${c.inkMuted}" font-variant-numeric="tabular-nums">best of ${runs.length} (${range})</text>`,
+      );
+    }
+  });
+  const fy = HEADER_H + rows.length * ROW_H + 38;
+  parts.push(
+    `<text x="${PAD}" y="${fy}" font-size="10.5" fill="${c.inkMuted}">${esc(data.gpu ?? "")} · temperature 0 · scenarios: ${esc((data.scenarios ?? []).map((s) => s.id).join(" · "))}</text>`,
+    `<text x="${PAD}" y="${fy + 15}" font-size="10.5" fill="${c.inkMuted}">Reproduce with your own models: npm run arena — github.com/artokun/comfyui-mcp</text>`,
+    `</svg>`,
+  );
+  return parts.join("\n");
+}
+
+const outDir = dirname(resultsPath);
+for (const mode of ["light", "dark"]) {
+  const file = join(outDir, `arena-leaderboard-${mode}.svg`);
+  writeFileSync(file, render(mode));
+  console.log(`wrote ${file}`);
+}