AI导哈

AI图像生成服务

一个Model Context Protocol (MCP)服务器，使Claude Desktop能够与本地ComfyUI安装进行交互，实现AI驱动的图像生成。

  • by Nikolaibibo
  • TypeScript
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 Nikolaibibo/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文档。

相关 MCP