作者 joenorton · joenorton/comfyui-mcp-server
本地ComfyUI作为MCP工具—无需打开ComfyUI UI即可生成图像、音频和视频、运行工作流程和管理资产。
comfyui-mcp-server将本地运行的ComfyUI （端口8188 ）桥接到任何MCP客户端。代理可以通过MCP工具生成和重新生成图像、提交自定义工作流程、轮询和取消作业、查看生成的资产、切换模型和发布输出。对于不想手动拖动节点的迭代创意工作、批量生成和编程管道运行非常有用。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"comfyui-mcp-server": {
"command": "python",
"args": [
"server.py"
],
"_inferred": false,
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"comfyui-mcp-server": {
"command": "python",
"args": [
"server.py"
],
"_inferred": false,
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"comfyui-mcp-server": {
"command": "python",
"args": [
"server.py"
],
"_inferred": false,
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"comfyui-mcp-server": {
"command": "python",
"args": [
"server.py"
],
"_inferred": false,
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "comfyui-mcp-server",
"command": "python",
"args": [
"server.py"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"comfyui-mcp-server": {
"command": {
"path": "python",
"args": [
"server.py"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add comfyui-mcp-server -- python server.py一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 您已设置ComfyUI ，但希望通过聊天而不是节点图进行迭代。
结果： 无需单击节点即可快速迭代。
何时使用： 您已经构建了一个工作流；现在您想以编程方式运行它。
结果： 来自聊天的工作流程编排—非常适合批量运行。
何时使用： 您有一个ComfyUI视频工作流程（例如， AnimateDiff/Mochi ） ，并希望按顺序输入提示。
结果： 通过本地计算的短视频，每次渲染不收取云费用。
将此MCP与Claude-Code-in-ComfyUI编辑器配对，以实现全管道创作
将mcp-image用于一次性Gemini gens ；将ComfyUI用于本地SD/FLUX管道
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| generate_image | prompt, settings | 标准文本到图像 | local compute only |
| generate_song / generate_video | prompt, workflow | 通过专用工作流程生成音频/视频 | local compute |
| regenerate | reference job_id, tweaks | 迭代关闭先前的结果 | local compute |
| view_image | asset_id | 内联显示资产 | 0 |
| get_queue_status / get_job / cancel_job | job_id | 客户生命周期管理 | 0 |
| list_assets / get_asset_metadata | filter | 浏览生成的输出 | 0 |
| list_models / get_defaults / set_defaults | optional model name | 切换检查点或调整默认值 | 0 |
| list_workflows / run_workflow | name + inputs | 运行已保存的工作流 | 0 to start |
| publish_asset / get_publish_info | asset_id | 标记最终资产 | 0 |
连接被拒绝127.0.0.1: 8188首先启动ComfyUI ；在浏览器中确认UI加载。
curl localhost:8188/system_stats工作流程失败，缺少自定义节点打开ComfyUI管理器并安装所需的自定义节点，然后重试。
Manager → Install Missing Custom Nodes作业队列但从未完成检查ComfyUI自己的控制台是否存在CUDA OOM或模型加载错误。
Inspect the ComfyUI terminal output| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| comfy-pilot | 您需要一个编辑器，让Claude在ComfyUI本身中起草工作流程 | 不是纯MCP服务器；需要安装ComfyUI节点 |
| mcp-image | 您希望通过Gemini进行零设置云生成 | 按图片付费；工作流程灵活性较低 |
| everart | 您需要经过风格训练的云模型 | 不同的提供商 |