comfyui-mcp Skill：用自然语言接管 ComfyUI 的 AI 全能控制台

Skill超级捕获手 技术创作者 2026-08-22 11 阅读

总结

comfyui-mcp 是一个将 ComfyUI 打造成”AI 原生控制台”的 MCP 服务器，同时配备自然语言驱动的可视化 Agent Panel，让用户通过对话就能操控 ComfyUI 的完整工作流——构图、生成图片/视频/音频、管理模型和自定义节点。项目2026年2月上线，5个月内狂揽647星，近30天净增162星，月下载量高达16.8万次，是今年图像生成类 Skill 中增长最快的黑马。

功能与原则

核心能力： 把 ComfyUI 的底层 API 封装成结构化 MCP 工具，再由 AI Agent 用自然语言驱动整个流程——不只是”传一个 prompt 返回一张图”，而是真正编辑节点图、迭代工作流、管理模型文件。

设计原则：
– Local-first：优先运行在本地（Mac/Linux/Windows），同一套配置覆盖 LAN/VPS/Comfy Cloud
– Model-agnostic：Claude、ChatGPT、Gemini、Ollama 都可以驱动，也可以接 DeepSeek/GLM/MiMo/Kimi 等任何 OpenAI 兼容端点
– Expertise-embedded：内置各模型特定的采样器、CFG、分辨率指南和下载链接，让 AI 第一次就能做对，不需要反复试错
– 安全可控：自带 path sanitization、rate limiting 和 audit logging，生产环境可用

认可度

  • GitHub Star：647（截至 2026-08-22），5个月内从0到647，近30天净增162星（约每天5星）
  • Forks：99，社区参与度高
  • 月下载量：16.8万次（167.9k Downloads / month）
  • GitHub Trending： 曾在 trending-repos.com 周榜排名#937，月榜#1509，持续被社区发现
  • npm 周下载： 持续增长中（npm version 活跃）
  • Issues/Pull Requests： 维护活跃，最后一次 push 就在今天（2026-08-22）

链接

GitHub：https://github.com/artokun/comfyui-mcp

原作者

artokun（GitHub username: artokun），独立开发者，专注 AI 图像生成工具链。同时还维护着 comfyui-mcp-panel（ComfyUI 侧边栏 Agent Panel）和 comfyui-mcp.artokun.io 完整文档站。Discord 社区活跃，更新频率极高。

介绍

comfyui-mcp 最早只是一个 ComfyUI 的 MCP 桥接器，现在已演变成完整的”AI Agent 控制平面”。它将 ComfyUI 的 178 个底层工具封装为结构化 MCP 接口，包括：图片生成、workflow 编排、节点图编辑、模型管理、自定义节点安装、性能调优等。配合内置的 41 个 AI skills（覆盖 Flux·WAN·LTX 视频·MiniMax H3·Qwen·Ideogram4·ERNIE·ANIMA 等），AI 能像资深 ComfyUI 用户一样精确选择采样器、CFG 和分辨率。

项目一大亮点是”Expert Skills”机制——每个模型都有专属的生成指南，包含推荐采样器、CFGs 范围、分辨率模板和 curated 下载链接。例如 Flux 模型会告诉 Agent：”使用 euler_ancestral 采样器，CFG 1.0-3.5，512-1024px”，不需要 Agent 自己试错。这套机制让 AI 生成质量显著提升，也大幅降低了普通用户的上手门槛。

另一个差异化特性是 ComfyUI Agent Panel（现已上架 ComfyUI-Manager）：一个嵌入 ComfyUI 界面的侧边栏 AI Agent，支持 Claude/ChatGPT/Gemini/任何 Ollama 或 OpenAI 兼容端点。用户可以在生成过程中实时看到节点图变化、查看 pending 消息、进行多 tab 管理，甚至在付费 API 扣款前主动确认。

特点

  • 全链路工作流编辑：不是简单的 prompt → 图片，而是 Agent 可以逐节点编辑 live graph、rewind/rollback、加载 workflow 模板
  • 多模型覆盖：Flux、LTX Video、WAN、Qwen、Ideogram4、MiniMax H3、ERNIE、ANIMA、Civitai 等主流模型的内置支持
  • 本地优先(local-first)：无需云端 API，本地 Ollama 完全离线可用；有 GPU 的用户可以零成本跑满
  • 一键部署 GPU Pod：官方提供 RunPod 一键部署模板，带 ComfyUI + Agent Panel + ComfyUI-Manager v2，开箱即用
  • 结构化输出：所有工具返回 Pydantic 约束的 schema，Agent 无需猜测返回格式；支持 streamable-HTTP 远程模式
  • Expert Skills 系统：每个模型有专属生成指南，AI 第一次就能选对参数，减少试错成本
  • 并发安全：后台任务通过 TaskExtension 管理，长时任务不阻塞请求

使用方法

安装步骤：

  1. 安装 ComfyUI（ComfyUI Desktop 或从源码安装）
  2. 将以下配置加入 Claude Code 的 ~/.claude/settings.json：
{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": ""
      }
    }
  }
}
  1. 启动 ComfyUI，确保在本地运行（默认端口 8188）
  2. 直接用自然语言驱动：
> Generate an image of a sunset over mountains in Studio Ghibli style

Agent 会自动：找到或下载 checkpoint → 构建工作流节点图 → 执行渲染 → 返回图片。

高级部署（远程/云端）：

# Streamable-HTTP 模式，暴露给远程客户端
npx -y comfyui-mcp@latest --http --host 0.0.0.0 --port 9100

# 一键隧道（Claude Desktop Custom Connectors 用）
npx -y comfyui-mcp@latest --tunnel

本地模型（Ollama，无需 API key）：

ollama pull artokun/gemma4-comfyui-mcp:e4b
# 然后在 Claude Code 中直接用自然语言驱动 ComfyUI

使用场景与人群

适用场景：
– AI 图像/视频生成工作流自动化（需要精细控制 ComfyUI 节点图的用户）
– 批量生成 + 自动迭代（AI 自动调整参数跑多版本）
– ComfyUI 自定义节点/模型管理（AI 帮你安装、更新、排查问题）
– 离线/私有化部署（本地 Ollama + comfyui-mcp，无需网络和 API 费用）
– Comfy Cloud 用户需要 Agent 驱动的替代方案（官方 ComfyUI Agent 目前仅限 Comfy Cloud 内部）

目标用户：
– 有本地 GPU、深度使用 ComfyUI 的 AI 创作者和开发者
– 需要用 Claude/ChatGPT/Gemini 等大模型精确操控图像生成流程的用户
– AI 应用开发者（把 ComfyUI 能力接入到自己产品的工具链中）
– Prompt 工程师（想通过 Agent 自动生成和迭代 Stable Diffusion/Flux 工作流）

输入与输出案例

案例1：自然语言生成图片

输入：

Generate an image of a cyberpunk city at night, neon rain reflections, cinematic lighting, 4K

输出：
Agent 自动执行：
1. 检测本地 Flux/checkpoint 可用性
2. 构建节点图（LoadCheckpoint → KSampler → VAEEncode → SaveImage）
3. 使用推荐的 Flux 采样参数（euler_ancestral, CFG 1.0-3.5）
4. 返回生成的 PNG 图片路径

案例2：编辑已有工作流

输入：

My current workflow uses SDXL, but I want to switch to Flux and upscale 2x. Can you modify the graph?

输出：
Agent 自动：
1. 读取当前 workflow JSON
2. 替换 checkpoint 节点为 Flux 对应版本
3. 在 KSampler 前插入 Upscale 节点（使用 ESRGAN 或类似）
4. 调整分辨率参数，输出新的节点图
5. 确认后可立即执行

相关资源：
– GitHub：https://github.com/artokun/comfyui-mcp
– 文档：https://comfyui-mcp.artokun.io/docs
– Agent Panel（ComfyUI-Manager 可搜索安装）：comfyui-agent-panel
– Discord 社区：https://discord.gg/cW9arBhzCu

GitHub: https://github.com/artokun/comfyui-mcp

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读