npm install @reaatech/media-pipeline-mcp-comfyui
# or
pnpm add @reaatech/media-pipeline-mcp-comfyui

import { ComfyUIProvider } from "@reaatech/media-pipeline-mcp-comfyui";
 
const provider = new ComfyUIProvider({
  baseUrl: "http://localhost:8188",
  downloadOutputs: true,
});
 
const result = await provider.execute({
  operation: "image.generate",
  params: {
    prompt: "A majestic dragon flying over a castle at sunset",
    negative_prompt: "blurry, low quality, distorted",
    seed: 42,
    steps: 30,
    cfg: 7,
    width: 1024,
    height: 1024,
  },
  config: {},
});
 
console.log(result.metadata.workflow); // "sdxl-text2img"
console.log(result.metadata.prompt_id); // "abc123..."
console.log(result.costUsd); // 0

const result = await provider.execute({
  operation: "image.generate",
  params: {
    prompt: "A futuristic city skyline, neon lights, cyberpunk",
    seed: 100,
    steps: 20,
    model: "workflow:flux-text2img",
  },
  config: {},
});

const provider = new ComfyUIProvider({
  baseUrl: "http://localhost:8188",
  workflowsDir: "./my-workflows",
});
 
// Workflows are loaded lazily on first execution
const result = await provider.execute({
  operation: "image.generate",
  params: {
    model: "workflow:custom/my-ip-adapter",
    prompt: "A portrait in the style of Van Gogh",
    image: "https://example.com/reference.png",
  },
  config: {},
});

interface ComfyUIConfig {
  baseUrl?: string;          // Default: "http://localhost:8188"
  workflowsDir?: string;     // Directory of custom JSON workflow files
  downloadOutputs?: boolean; // Default: true
  pollIntervalMs?: number;   // Default: 1000
  retentionMs?: number;      // Default: 600000 (10 min)
}

interface ComfyUIWorkflow {
  name: string;
  apiFormat: object;                           // Raw ComfyUI API JSON
  inputs: Record<string, ComfyParamSpec>;      // Typed input parameters
  outputs: Record<string, "image" | "video" | "mask" | "latent">;
}

interface ComfyParamSpec {
  path: string;                                 // Dot-separated JSON path (e.g. "6.inputs.text")
  type: "string" | "number" | "boolean" | "enum";
  enum?: string[];
  default?: unknown;
  required?: boolean;
}