Claude Comfyui MCP

ComfyUI MCP服务器

一个模型上下文协议（MCP）服务器，使Claude Desktop能够与您的本地ComfyUI安装进行交互，以生成AI驱动的图像。

特性

• 15个MCP工具 完整的ComfyUI控件
• 基于模板的生成 （通量、SD1.5、SDXL、img2img）
• 自定义工作流执行 具有智能参数覆盖功能
• 实时进度监控 通过WebSocket
• 模型管理 （列出检查点、LoRA、VAE等）
• 工作流库 用于保存和重用工作流
• 队列管理 （状态、取消、清除）
• 图像上传/检索 具有完整的Windows路径支持

先决条件

• Node.js v20或更高
• Comfy用户界面 安装并运行于 http://127.0.0.1:8188
• 克劳德桌面 （用于MCP集成）
• Windows 11 （根据规范）

安装

1.安装依赖项

\[！注意\] 以下示例中的文件路径必须替换为适用于您系统的正确路径。

cd [Path to your ComfyUI MCP Server]
npm install

2.配置路径

编辑 config.json 要匹配您的ComfyUI安装：

{
  "comfyui": {
    "installation_path": "[Path to your ComfyUI portable installation]"
  }
}

3.构建服务器

npm run build

4.配置克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "node",
      "args": [
        "[Path to your ComfyUI MCP Server]\\dist\\index.js"
      ],
      "env": {
        "COMFYUI_CONFIG": "[Path to your ComfyUI MCP Server]\\config.json"
      }
    }
  }
}

5.重新启动克劳德桌面

ComfyUI工具现在将在Claude Desktop中可用。

可用工具

生成

• comfy_submit_workflow -提交带有覆盖的自定义工作流JSON
• comfy_generate_simple -使用模板快速生成

状态与监控

• comfy_get_status -检查发电状态和输出
• comfy_wait_for_completion -等待生成完成

模型管理

• comfy_list_models -列出可用型号、LoRA、VAE

工作流库

• comfy_save_workflow -将工作流保存到库
• comfy_load_workflow -加载已保存的工作流
• comfy_list_workflows -列出所有已保存的工作流
• comfy_delete_workflow -从库中删除工作流

队列管理

• comfy_get_queue -获取当前队列状态
• comfy_cancel_generation -取消生成
• comfy_clear_queue -清除待处理的队列项目

公用事业

• comfy_upload_image -将图像上传到ComfyUI输入文件夹
• comfy_get_output_images -列出最近输出的图像

用法示例

简单的文本到图像生成

问克劳德：

Generate an image of a sunset over mountains using Flux

克劳德将使用 comfy_generate_simple 使用flux_txt2img模板。

自定义工作流执行

Use my chrono_edit workflow to animate this product image

克劳德将：

1. 加载您的工作流 comfy_load_workflow
2. 上传图像 comfy_upload_image
3. 提交 comfy_submit_workflow 和参数覆盖

检查可用型号

What Flux models do I have available?

克劳德将使用 comfy_list_models 过滤器=“通量”。

配置

模板默认值

编辑 config.json 要自定义模板默认值，请执行以下操作：

{
  "templates": {
    "flux_txt2img": {
      "default_model": "flux_dev.safetensors",
      "default_steps": 20,
      "default_cfg": 3.5
    }
  }
}

工作流库路径

工作流保存到：

[Path to your ComfyUI portable installation]\ComfyUI\user\default\workflows\mcp_library

故障排除

“无法连接到ComfyUI”

• 确保ComfyUI正在运行： run_nvidia_gpu.bat
• 检查ComfyUI是否可访问 http://127.0.0.1:8188
• 验证端口8188未被防火墙阻止

“找不到模型”

• 跑 comfy_list_models 查看可用型号
• 检查模型文件是否存在于正确的文件夹中
• 验证模型名称拼写是否完全匹配

“工作流验证失败”

• 首先在ComfyUI UI中测试工作流
• 检查所有节点连接是否有效
• 确保所有必需的型号都可用

权限错误

• 检查ComfyUI目录上的文件夹权限
• 如果需要，以管理员身份运行Claude Desktop
• 验证中的路径 config.json 可访问

发展

内置监视模式

npm run dev

清洁建筑

npm run clean
npm run build

建筑

Claude Desktop (stdio) → MCP Server → ComfyUI API (HTTP/WebSocket)
                              ↓
                         File System
                         - Models
                         - Input/Output
                         - Workflow Library

MCP服务器作为一个单独的Node.js进程运行，并通过其HTTP API和WebSocket连接与ComfyUI通信。确实如此 不 修改任何ComfyUI文件。

许可证

麻省理工学院

支持

有关问题和疑问，请参阅规范文档或ComfyUI API文档。