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),
128 lines • 6.03 kB
JavaScript
import { z } from "zod";
import { AssetRegistry, applyOverrides } from "../services/asset-registry.js";
import { enqueueWorkflow } from "../services/workflow-executor.js";
import { viewAssetImage } from "../services/view-image.js";
import { errorToToolResult } from "../utils/errors.js";
function summarizeRecord(record) {
if (!record)
return null;
return {
asset_id: record.assetId,
prompt_id: record.promptId,
node_id: record.nodeId,
filename: record.filename,
subfolder: record.subfolder,
type: record.type,
url: record.url,
created_at: new Date(record.createdAt).toISOString(),
};
}
export function registerAssetTools(server) {
server.tool("view_image", "Fetch a registered asset's bytes and return them as an inline image so the agent can see the result. Use this after enqueue_workflow completes (asset_id is included in the completion notification) to inspect, critique, or compare generated images. Only supports image mime types (PNG/JPEG/WebP); audio/video assets must be saved to disk via get_image.", {
asset_id: z.string().describe("Asset id returned by list_assets or job completion"),
}, async ({ asset_id }) => {
try {
const result = await viewAssetImage(asset_id);
return {
content: result.content.map((block) => block.type === "image"
? { type: "image", data: block.data, mimeType: block.mimeType }
: { type: "text", text: block.text }),
};
}
catch (err) {
return errorToToolResult(err);
}
});
server.tool("list_assets", "List recently generated assets from the in-memory registry, newest-first. Assets are registered automatically when a workflow completes successfully. The registry is ephemeral and clears on server restart; records expire after COMFYUI_ASSET_TTL_HOURS (default 24h).", {
limit: z
.number()
.int()
.positive()
.optional()
.describe("Max records to return (default: all)"),
since: z
.string()
.datetime()
.optional()
.describe("ISO timestamp — only return assets created at or after this time"),
}, async (args) => {
try {
const since = args.since ? Date.parse(args.since) : undefined;
const records = AssetRegistry.list({ limit: args.limit, since });
return {
content: [
{
type: "text",
text: JSON.stringify({ count: records.length, assets: records.map(summarizeRecord) }, null, 2),
},
],
};
}
catch (err) {
return errorToToolResult(err);
}
});
server.tool("get_asset_metadata", "Get full provenance for a registered asset including the workflow snapshot that produced it. Use this to inspect the parameters that generated an image before calling regenerate with overrides.", {
asset_id: z.string().describe("Asset id returned by list_assets or job completion"),
}, async ({ asset_id }) => {
try {
const record = AssetRegistry.get(asset_id);
if (!record) {
return errorToToolResult(new Error(`No asset found for id "${asset_id}". It may have expired or never been registered.`));
}
return {
content: [
{
type: "text",
text: JSON.stringify({
...summarizeRecord(record),
workflow: record.workflow,
}, null, 2),
},
],
};
}
catch (err) {
return errorToToolResult(err);
}
});
server.tool("regenerate", "Re-enqueue the workflow that produced an existing asset, optionally applying parameter overrides. Overrides are applied to any node input matching the key name (e.g. cfg, steps, sampler_name, scheduler, seed, denoise, text). Seeds are re-randomized by default so each regenerate yields a fresh image unless seed is explicitly passed in overrides.", {
asset_id: z.string().describe("Asset id of the source generation"),
overrides: z
.record(z.string(), z.any())
.optional()
.describe("Map of input-name → new value applied to every node that already has that input. " +
"Common keys: cfg, steps, sampler_name, scheduler, seed, denoise, text."),
disable_random_seed: z
.boolean()
.optional()
.describe("If true, do not randomize seed fields. Combine with `overrides.seed` to reproduce the exact original image."),
}, async ({ asset_id, overrides, disable_random_seed }) => {
try {
const record = AssetRegistry.get(asset_id);
if (!record) {
return errorToToolResult(new Error(`No asset found for id "${asset_id}". It may have expired or never been registered.`));
}
const next = applyOverrides(record.workflow, overrides);
const result = await enqueueWorkflow(next, { disable_random_seed });
return {
content: [
{
type: "text",
text: JSON.stringify({
status: "enqueued",
prompt_id: result.prompt_id,
queue_remaining: result.queue_remaining,
source_asset_id: asset_id,
overrides_applied: overrides ?? {},
}, null, 2),
},
],
};
}
catch (err) {
return errorToToolResult(err);
}
});
}
//# sourceMappingURL=assets.js.map