UNPKG

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),

267 lines • 11.5 kB
import { isAbsolute, join, resolve } from "node:path"; import { config } from "../config.js"; import { getSystemStats } from "../comfyui/client.js"; import { resolveEffectiveComfyUIBase } from "./workspace-env.js"; import { ValidationError } from "../utils/errors.js"; import { logger } from "../utils/logger.js"; // --------------------------------------------------------------------------- // Resolve ComfyUI's REAL output directory. // // ComfyUI can be launched with --output-directory (or --base-directory) which // redirects generated images away from the default <COMFYUI_PATH>/output (e.g. // to a shared drive like ComfyUI-Shared\output). Tools that scan the output // directory on the local filesystem (convert_image, list_output_images) must // therefore NOT assume <COMFYUI_PATH>/output, or they find nothing after a // successful render. // // The authoritative source is ComfyUI itself: /system_stats reports the launch // argv (system.argv), from which we parse --output-directory / --base-directory. // We fall back to <COMFYUI_PATH>/output when ComfyUI is unreachable or did not // override the directory. Same class of fix as the doubled-COMFYUI_PATH bug. // --------------------------------------------------------------------------- /** Resolve a possibly-relative dir against a base (or COMFYUI_PATH, or cwd). */ function resolveDir(value, base) { if (isAbsolute(value)) return resolve(value); const root = base ?? config.comfyuiPath ?? process.cwd(); return resolve(root, value); } /** Read a flag's value supporting both `--flag value` and `--flag=value`. */ function flagValue(argv, index, flag) { const token = argv[index]; if (token === flag) return argv[index + 1]; if (token.startsWith(`${flag}=`)) return token.slice(flag.length + 1); return undefined; } /** * Parse the configured output directory out of ComfyUI's launch argv. * --output-directory wins; otherwise --base-directory implies <base>/output. * Returns undefined when neither flag is present. */ export function parseOutputDirFromArgv(argv) { if (!argv || argv.length === 0) return undefined; let outputDir; let baseDir; for (let i = 0; i < argv.length; i++) { outputDir = flagValue(argv, i, "--output-directory") ?? outputDir; baseDir = flagValue(argv, i, "--base-directory") ?? baseDir; } const resolvedBase = baseDir ? resolveDir(baseDir) : undefined; if (outputDir) return resolveDir(outputDir, resolvedBase); if (resolvedBase) return join(resolvedBase, "output"); return undefined; } /** * Parse the running server's base directory (`--base-directory`) out of its * launch argv. This is the authoritative root ComfyUI derives models/, input/, * output/, and user/ from — on a Desktop install it commonly points at a drive * entirely different from COMFYUI_PATH (the code checkout). Returns undefined * when the flag is absent. */ export function parseBaseDirFromArgv(argv) { if (!argv || argv.length === 0) return undefined; let baseDir; for (let i = 0; i < argv.length; i++) { baseDir = flagValue(argv, i, "--base-directory") ?? baseDir; } return baseDir ? resolveDir(baseDir) : undefined; } /** * Parse the models directory the running server actually reads from. ComfyUI's * `--models-directory` overrides the models folder in `--base-directory`, so it * wins; otherwise the models root is `<base>/models`. Returns undefined when * neither flag is present. */ export function parseModelsDirFromArgv(argv) { if (!argv || argv.length === 0) return undefined; const base = parseBaseDirFromArgv(argv); let modelsDir; for (let i = 0; i < argv.length; i++) { modelsDir = flagValue(argv, i, "--models-directory") ?? modelsDir; } if (modelsDir) return resolveDir(modelsDir, base); return base ? join(base, "models") : undefined; } /** * Collect all values that follow `flag` at position `index`, supporting both * `--flag a b` (argparse nargs='+') and `--flag=a`. Consumes consecutive tokens * until the next `--option`. Returns [] when the token at `index` isn't `flag`. */ function multiFlagValues(argv, index, flag) { const token = argv[index]; if (token.startsWith(`${flag}=`)) return [token.slice(flag.length + 1)]; if (token !== flag) return []; const values = []; for (let j = index + 1; j < argv.length; j++) { if (argv[j].startsWith("--")) break; values.push(argv[j]); } return values; } /** * Parse every `--extra-model-paths-config` value out of the launch argv. ComfyUI * declares this flag as `nargs='+', action='append'`, so it can carry multiple * files per occurrence AND be repeated — both forms are collected here. This is * the config file(s) the running server actually loads extra model search paths * from — on ComfyUI Desktop it is an auto-generated * `…\Comfy Desktop\shared_model_paths.yaml`, NOT the app-data * `ComfyUI\extra_models_config.yaml` the tools historically guessed. Returns [] * when the flag is absent. */ export function parseExtraModelPathsConfigsFromArgv(argv) { if (!argv || argv.length === 0) return []; const out = []; for (let i = 0; i < argv.length; i++) { for (const v of multiFlagValues(argv, i, "--extra-model-paths-config")) { out.push(resolveDir(v)); } } return out; } /** * Resolve the models directory the CONNECTED server actually reads from. Asks * the running ComfyUI (/system_stats argv → `--base-directory`) first; falls * back to `<COMFYUI_PATH>/models`. This is the source of truth for * download_model's destination so files land where the live server sees them * (issues #346/#369) rather than in a stale COMFYUI_PATH install. */ export async function resolveModelsDir() { try { const stats = await getSystemStats(); const fromArgv = parseModelsDirFromArgv(stats.system?.argv); if (fromArgv) { logger.debug("Resolved ComfyUI models directory from launch argv", { modelsDir: fromArgv, }); return fromArgv; } } catch (err) { logger.debug("Could not resolve models dir from /system_stats; using COMFYUI_PATH/models", { error: err instanceof Error ? err.message : String(err) }); } // No live-server base dir available. Fall back to the effective LOCAL base: // COMFYUI_PATH, else the saved default workspace (set_default_workspace) when // NOT in remote mode — so a download resolves to that install rather than // hard-failing just because COMFYUI_PATH is unset (#415/#416). resolveModelsDir // is only reached in local mode (remote downloads short-circuit to the Manager // before any local-dir resolution), so the default workspace is a safe target. const base = resolveEffectiveComfyUIBase(); if (base) return resolve(base, "models"); throw new ValidationError("No local ComfyUI models directory could be resolved. Set the COMFYUI_PATH " + "environment variable, save a default workspace with set_default_workspace, " + "or connect to a running ComfyUI so its models directory can be detected."); } /** * Best-effort: the running server's `--extra-model-paths-config` file, or * undefined when unreachable / not launched with the flag. Never throws. */ export async function resolveServerExtraModelConfig() { try { const stats = await getSystemStats(); const configs = parseExtraModelPathsConfigsFromArgv(stats.system?.argv); return configs[0]; } catch { return undefined; } } /** <COMFYUI_PATH>/output fallback. Throws if COMFYUI_PATH is unset. */ export function localOutputDirFallback() { if (!config.comfyuiPath) { throw new ValidationError("COMFYUI_PATH is not configured. Set the COMFYUI_PATH environment variable."); } return resolve(config.comfyuiPath, "output"); } // --------------------------------------------------------------------------- // Resolve ComfyUI's REAL input directory — the exact mirror of the output-dir // logic above. ComfyUI can be launched with --input-directory (or // --base-directory) which redirects the LoadImage / VHS_LoadVideo / LoadAudio // search path away from the default <COMFYUI_PATH>/input. Filesystem-path tools // that write or check files in the input directory must therefore NOT assume // <COMFYUI_PATH>/input, or a server with a custom --input-directory rejects the // file ("Invalid image file") while the tool reports success. Prefer the server // API (/upload/image, see stage_output_as_input) when possible; use this only // for genuine local filesystem operations. // --------------------------------------------------------------------------- /** * Parse the configured input directory out of ComfyUI's launch argv. * --input-directory wins; otherwise --base-directory implies <base>/input. * Returns undefined when neither flag is present. */ export function parseInputDirFromArgv(argv) { if (!argv || argv.length === 0) return undefined; let inputDir; let baseDir; for (let i = 0; i < argv.length; i++) { inputDir = flagValue(argv, i, "--input-directory") ?? inputDir; baseDir = flagValue(argv, i, "--base-directory") ?? baseDir; } const resolvedBase = baseDir ? resolveDir(baseDir) : undefined; if (inputDir) return resolveDir(inputDir, resolvedBase); if (resolvedBase) return join(resolvedBase, "input"); return undefined; } /** <COMFYUI_PATH>/input fallback. Throws if COMFYUI_PATH is unset. */ export function localInputDirFallback() { if (!config.comfyuiPath) { throw new ValidationError("COMFYUI_PATH is not configured. Set the COMFYUI_PATH environment variable."); } return resolve(config.comfyuiPath, "input"); } /** * Resolve the directory ComfyUI actually reads inputs from. Asks the running * ComfyUI (/system_stats argv) first; falls back to <COMFYUI_PATH>/input. */ export async function resolveInputDir() { try { const stats = await getSystemStats(); const fromArgv = parseInputDirFromArgv(stats.system?.argv); if (fromArgv) { logger.debug("Resolved ComfyUI input directory from launch argv", { inputDir: fromArgv, }); return fromArgv; } } catch (err) { logger.debug("Could not resolve input dir from /system_stats; using COMFYUI_PATH/input", { error: err instanceof Error ? err.message : String(err) }); } return localInputDirFallback(); } /** * Resolve the directory ComfyUI actually writes outputs to. Asks the running * ComfyUI (/system_stats argv) first; falls back to <COMFYUI_PATH>/output. */ export async function resolveOutputDir() { try { const stats = await getSystemStats(); const fromArgv = parseOutputDirFromArgv(stats.system?.argv); if (fromArgv) { logger.debug("Resolved ComfyUI output directory from launch argv", { outputDir: fromArgv, }); return fromArgv; } } catch (err) { logger.debug("Could not resolve output dir from /system_stats; using COMFYUI_PATH/output", { error: err instanceof Error ? err.message : String(err) }); } return localOutputDirFallback(); } //# sourceMappingURL=output-dir.js.map