正在整理你需要的资料…
artokun/comfyui-mcp ↗ · 项目主页 ↗
ComfyUI 的节点图要一格格点,批量出图更烦。comfyui-mcp 由 MCP 服务器加侧栏 Agent 组成,能生成图像视频音频、编排并运行工作流、用自然语言改实时节点图,178 个工具、36 个技能,任意 LLM 都接得住。一份配置通吃本地、局域网、VPS 或 Comfy Cloud。
适合想用对话驱动 ComfyUI 出图出片的创作者与自动化团队;内置模型竞技场能横向量化对比各家模型表现,但渲染仍要自己备显卡和模型。
下面是把仓库 README 逐节读完后归纳出的中文要点。
由智能体面板端到端驱动 ComfyUI:读取本地已装组件、连好工作流、释放显存并执行渲染,附 76 秒演示;这是本地优先、以智能体为中心的控制层,由 MCP 服务器加常驻侧边栏智能体组成,可生成图像、视频与音频,编写并运行工作流,管理模型与自定义节点,并用自然语言改实时画布;模型自选,可用 Claude 或 ChatGPT 订阅、Gemini 登录、Ollama 免费本地模型,或用一把 API key 接 DeepSeek、GLM、MiMo、Kimi 等
先装好 ComfyUI(桌面版或从源码构建),再把 MCP 服务器写进 Claude Code 的配置(~/.claude/settings.json);ComfyUI 跑起来后直接让 Claude 生成一张图,Claude 会找到或下载 checkpoint、搭好工作流、执行并把图片返回
这个包同时以 Claude Code 插件形式发布,在 MCP 工具之上加了斜杠命令、技能、智能体与钩子;斜杠命令包括 /comfy:gen 按描述生成图片、/comfy:viz 把工作流可视化成 Mermaid 图、/comfy:node-skill 为自定义节点包生成技能、/comfy:debug 诊断工作流失败原因、/comfy:batch 做参数扫描、/comfy:convert 在界面与接口格式间转换、/comfy:install 安装节点包、/comfy:gallery 浏览产物、/comfy:compare 并排对比两个工作流、/comfy:recipe 多步配方;技能共 42 个,packs/ 目录另有 13 种一键安装组合
除无界面的 MCP 服务器外,这个包还提供驱动 ComfyUI 智能体面板的编排器,它是嵌在 ComfyUI 侧边栏里自主运作的智能体,在后台用你自己的 Claude 或 ChatGPT 订阅运行,由面板的 Connect 按钮按需启动;当 ComfyUI 跑在没有 Node 或智能体的机器上(如 RunPod 云主机)时,智能体仍可在你本机运行并驱动远端 ComfyUI,远端无需登录也不用装任何东西;远端 HTTPS 场景会开一个带令牌校验的 wss:// 隧道(经 Cloudflare),本地场景走 ws://127.0.0.1:9199 回环桥接
共 38 个工具,覆盖工作流执行、生成、迭代、合成、模型等方向:generate_image 可做文生图、ControlNet 条件生成、IP-Adapter 参考图引导、短视频(LTX-2.3,本地 GPU)或 3D 模型生成、ESRGAN 超分与 BiRefNet 抠图,另有生成音频(ACE Step 1.5 与 Stable Audio 3);get_image 可回看结果图、取调色与对比度统计、按 asset_id 重跑工作流、浏览近期产物并查看完整来源信息
服务器会自动探测本机 ComfyUI 的安装位置与端口,需要时可用环境变量覆盖;面板用户的密钥填在 API Keys 卡片里,存放在 ~/.comfyui-mcp/panel-secrets.json 且无需重启即生效;只用 MCP 的部署(如 Claude Desktop、Claude Code)则在客户端配置的 env 段填写,真实环境变量始终优先于已存密钥;开发时服务器还会加载 ~/.comfyui-mcp/.env 作为覆盖文件,整体有三种运行模式由环境自动选择
npx -y comfyui-mcp@latest --tunnelscripts/
generation-stats.mjs # CLI: npm run generations:stats
src/
index.ts # MCP server entry point (stdio transport)
config.ts # Auto-detection & environment config
comfyui/
client.ts # ComfyUI WebSocket/HTTP client wrapper
types.ts # TypeScript interfaces
services/
workflow-executor.ts # Execute workflows, handle images & errors
workflow-composer.ts # Templates (txt2img, img2img, upscale, inpaint)
workflow-validator.ts # Dry-run validation (missing nodes, models, connections)
image-management.ts # Upload images, extract PNG metadata, list outputs
mermaid-converter.ts # Workflow → Mermaid diagram
workflow-converter.ts # UI → API: de-virtualize Get/Set buses + Reroutes, expand subgraphs, resolve bypass (powers get_workflow's strip action)
workflow-slicer.ts # sliceWorkflow() — rgthree Fast-Groups-Bypass pipeline un-chunker (shared by the CLI + get_workflow's slice action)
mermaid-parser.ts # Mermaid diagram → Workflow
model-resolver.ts # HuggingFace search, local models, downloads
generation-tracker.ts # SQLite generation log, settings dedup, stats
file-hasher.ts # SHA256 hashing of .safetensors with cache
workflow-settings-extractor.ts # Extract settings from workflow JSON
process-control.ts # Stop, start, restart ComfyUI process
registry-client.ts # ComfyUI Registry API
skill-generator.ts| 主要语言 | TypeScript | 许可 | MIT |
|---|---|---|---|
| 创建时间 | 2026-02-15 | 最近提交 | 2026-11-16 |
| 站内采集 | 2026-11-06 起,连续观察 12 天 | 最近一次 | 2026-11-17 |
最近 4 次采集
2026-11-06 895 ★ → 2026-11-17 931 ★ (累计 +36)
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。