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),
93 lines • 4.19 kB
JavaScript
import { z } from "zod";
import { validateWorkflow } from "../services/workflow-validator.js";
import { errorToToolResult, ValidationError } from "../utils/errors.js";
function parseWorkflow(input) {
if (typeof input === "string") {
try {
const parsed = JSON.parse(input);
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
throw new ValidationError("Workflow JSON must be an object with node IDs as keys");
}
return parsed;
}
catch (err) {
if (err instanceof ValidationError)
throw err;
throw new ValidationError(`Invalid JSON string: ${err.message}`);
}
}
if (typeof input === "object" && input !== null && !Array.isArray(input)) {
return input;
}
throw new ValidationError("Workflow must be a JSON string or object");
}
export function registerWorkflowValidateTools(server) {
server.tool("validate_workflow", "Validate a ComfyUI workflow without executing it. Checks for missing node types, broken connections, invalid output indices, missing models, and other issues. Returns a list of errors and warnings.", {
workflow: z
.union([z.string(), z.record(z.string(), z.any())])
.describe("ComfyUI workflow in API format (JSON string or object)"),
health: z
.boolean()
.optional()
.default(true)
.describe("Include graph-health heuristics (disconnected nodes, duplicate model loads, orphaned branches, muted/bypassed nodes) as info/warning issues plus a structured health section. Never affects `valid`."),
}, async (args) => {
try {
const workflow = parseWorkflow(args.workflow);
const result = await validateWorkflow(workflow, { health: args.health });
const lines = [];
lines.push(`## ${result.summary}`);
lines.push("");
// Health findings are rendered in their own "### Graph health" section —
// exclude them from the Errors/Warnings buckets to avoid double-listing.
const nonHealth = result.issues.filter((i) => !i.kind);
if (nonHealth.length === 0) {
lines.push("No issues found. The workflow is ready to execute.");
}
else {
const errors = nonHealth.filter((i) => i.severity === "error");
const warnings = nonHealth.filter((i) => i.severity === "warning");
if (errors.length > 0) {
lines.push("### Errors");
for (const issue of errors) {
const loc = issue.node_id
? `Node ${issue.node_id} (${issue.node_type})`
: "Workflow";
lines.push(`- **${loc}**: ${issue.message}`);
}
lines.push("");
}
if (warnings.length > 0) {
lines.push("### Warnings");
for (const issue of warnings) {
const loc = issue.node_id
? `Node ${issue.node_id} (${issue.node_type})`
: "Workflow";
lines.push(`- **${loc}**: ${issue.message}`);
}
}
}
if (result.health) {
lines.push("");
lines.push("### Graph health");
lines.push(`- ${result.health.summary}`);
for (const f of result.health.findings) {
const tag = f.heuristic ? `${f.severity}, heuristic` : f.severity;
lines.push(`- [${tag}] ${f.detail}`);
}
}
return {
content: [
{
type: "text",
text: lines.join("\n"),
},
],
};
}
catch (err) {
return errorToToolResult(err);
}
});
}
//# sourceMappingURL=workflow-validate.js.map