comfyui-mcp 含 178 个工具与 36 个 AI skills
面向 ComfyUI 的本地优先、agent-native 控制平面——由 MCP server 加 sidebar agent 组成,可在任意 LLM(Claude、ChatGPT、Gemini、离线 Ollama 或任何托管模型)上用自然语言生成图像、视频和音频,编写并运行工作流,以及编辑你的实时图。
提供 178 个工具、36 个 AI skills、55 个 installer packs。
可运行在 Local、LAN、VPS 或 Comfy Cloud。
MCP 服务会以你的权限运行代码或访问你的数据。安装前请先看项目主页与源码,只给必要的权限;密钥请自行填入,不要提交到仓库。
claude mcp add comfyui-mcp -- npx -y comfyui-mcp@0.52.206
{
"mcpServers": {
"comfyui-mcp": {
"command": "npx",
"args": [
"-y",
"comfyui-mcp@0.52.206"
]
}
}
}安装方式由项目的发布配置推断,并已核对该包确属此仓库;需要的环境变量 / 密钥请看下方「怎么使用」
摘自项目自己的说明,具体以项目主页为准。
1. Install ComfyUI (if you haven't already): ComfyUI Desktop or from source
2. Add the MCP server to your Claude Code config (~/.claude/settings.json):
{
"mcpServers": {
"comfyui": {
"command": "npx",
"args": ["-y", "comfyui-mcp"],
"env": {
"CIVITAI_API_TOKEN": ""
}
}
}
}
3. Start using it. With ComfyUI running, ask Claude to generate an image:
> Generate an image of a sunset over mountains
Claude will find (or download) a checkpoint, build a workflow, execute it, and return the image.
Note: This runs as a standalone MCP server, so there is no need to clone this repo.
npxdownloads and runs it.
comfyui-mcp is local-first. A self-hosted ComfyUI on Mac/Linux/Windows is the primary target, and the same agent reaches remote installs (RunPod, VPS, LAN, reverse-proxied) from one config. Local-first, not local-only.
More than a bridge. Most ComfyUI MCP servers are thin connectors. They forward a prompt and hand back an image. comfyui-mcp is a full control plane. It authors and edits the graph node by node, runs and iterates on workflows, manages models and custom nodes, and ships model-specific expertise (samplers, CFG, resolutions, curated model URLs) so the agent gets it right without trial and error. If you want a minimal local relay, a lightweight server is fine. If you want an agent that operates ComfyUI, that's this project.
For Comfy Cloud users, Comfy-Org ships its own agent tooling: Comfy Cloud MCP (public beta, hosted on Comfy Cloud GPUs), the Comfy In-App Agent (private alpha, inside Comfy Cloud), and a first-party Comfy Local MCP (private test, not publicly available yet), all maintained by the Comfy team. If you don't have a GPU or you want zero setup, that's the better path; go use it.
Where this project differs is that it runs on your install and your choice of model, including a free local one via Ollama with no account and no network at all. comfyui-mcp also includes a community cloud mode (set COMFYUI_API_KEY, see Deployment modes) so a single MCP can target all three deployment shapes from one config.
…