comfyui-mcp:ComfyUI 的 MCP 服务器

核心信息

以下信息由程序从官方接口读取，不经模型改写。

仓库地址: https://github.com/artokun/comfyui-mcp
许可证: MIT
语言: TypeScript
维护方: artokun
主页: https://comfyui-mcp.artokun.io/docs
核验日期: 2026-11-04

它是什么

comfyui-mcp 是一个 MCP 服务器加实时侧边栏智能体,可生成图像、视频和音频,编写并运行工作流,管理模型和自定义节点,并用自然语言编辑实时的 ComfyUI 图。该软件包同时作为 Claude Code 插件发布,在 MCP 工具之上增加斜杠命令、技能、智能体和钩子。它由 @artokun 构建并维护。comfyui-mcp 采用 MIT 许可证。

主要能力

comfyui-mcp 提供 38 个工具,涵盖工作流执行、生成、迭代、组合、模型等。
gen 斜杠命令根据文字描述生成图像,自动选择检查点、构建工作流并返回图像。
viz 斜杠命令把工作流可视化为按类别分组节点的 Mermaid 图。
debug 斜杠命令诊断工作流失败的原因:读取历史和日志,追溯根本原因,并给出修复建议。
convert 斜杠命令在 UI 格式和 API 格式的工作流之间转换。
clear_vram 工具通过卸载缓存模型来释放 GPU 显存,调用 ComfyUI 的 free 接口,并报告前后统计。

怎么上手

comfyui-mcp 作为独立的 MCP 服务器运行,因此无需克隆该仓库。
安装 ComfyUI Agent Panel 时,在 ComfyUI-Manager 中搜索 comfyui-agent-panel。
comfyui-mcp 会自动检测你的 ComfyUI 安装和端口。
端口检测通过 system_stats 接口依次探测 8188(CLI 默认)和 8000(桌面应用默认)。

摘自 README · json

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": ""
      }
    }
  }
}

摘自 README

> Generate an image of a sunset over mountains

摘自 README · bash

# In Claude Code
/plugin marketplace add artokun/comfyui-mcp
/plugin install comfy

适合谁

comfyui-mcp 可在 macOS、Linux 和 Windows 上运行。自托管的 Mac/Linux/Windows 版 ComfyUI 是主要目标,同一个智能体通过一份配置即可连接远程安装(RunPod、VPS、LAN、反向代理)。comfyui-mcp 运行于三种模式之一,由环境自动选择。

它运行在用户自己的安装和所选模型上,包括通过 Ollama 使用的免费本地模型,无需账号也无网络。服务器默认使用 stdio。服务器通过 REST API 和 WebSocket 接口与 ComfyUI 通信。

开发需要至少 22.0.0 的 Node.js。upload_image 工具把本地图像复制到 ComfyUI 的 input 目录,用于 img2img、inpaint 或 ControlNet。每次 enqueue_workflow 调用都会把设置记录到本地 SQLite 数据库。

内置的 LLM Arena 在真实的 ComfyUI 任务上为每个模型评分。从图像提取工作流的示例会读取 PNG 元数据块,以恢复生成该图像所用的确切工作流和提示词。运行前验证的示例会检查缺失的节点类型、损坏的连接、无效的输出索引和缺失的模型文件,而不执行工作流。

参数扫描支持的参数有 cfg、steps、sampler、scheduler、seed、denoise、width 和 height。

本站已收录的相关工具。