ComfyUI控制协议服务器

舒适的mcp

MCP（模型上下文协议）服务器，用于从AI代理控制本地ComfyUI实例，如 克劳德协作 或 克劳德代码.

让代理理解、修改和执行ComfyUI工作流，从而实现迭代式AI辅助图像生成。应该与任何兼容MCP的代理一起使用，尽管它是在Claude Cowork的基础上构建的。

特性

• 了解工作流程 --解析工作流程JSON，并获得节点、连接和参数的人类可读描述
• 参数修改 --更改提示、种子、模型、采样器、分辨率和任何其他工作流参数
• PNG工作流提取 --从ComfyUI生成的PNG图像中提取嵌入式工作流元数据
• 工作流执行 --提交工作流、跟踪进度并在线检索生成的图像
• 可再现输出 --输出PNG具有自动嵌入的工作流元数据，因此可以将图像拖回ComfyUI，以在所有节点、连接和小部件值保持不变的情况下再现或调整结果
• 模型发现 --列出可用的检查点、LoRA、VAE、ControlNet模型、采样器和调度器
• 图片上传 --上传img2img、ControlNet和其他依赖输入的工作流的输入图像
• 队列管理 --监视、取消和清除执行队列
• 工作流存储 --在本地保存和加载工作流以供重用

平台支持

在上开发和测试 视窗。应适用于macOS和Linux，但尚未经过测试。

需求

• Node.js 22+
• 正在运行的ComfyUI实例

设置

npm install
npm run build

配置

添加到MCP客户端设置。对于Claude Code/Claude Cowork，请添加 .claude/settings.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "node",
      "args": ["C:\\path\\to\\comfy-mcp\\dist\\index.js"],
      "env": {
        "COMFYUI_HOST": "127.0.0.1:8000"
      }
    }
  }
}

为了开发，使用 tsx 相反：

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["tsx", "C:\\path\\to\\comfy-mcp\\src\\index.ts"],
      "env": {
        "COMFYUI_HOST": "127.0.0.1:8000"
      }
    }
  }
}

集 COMFYUI_HOST 以匹配您的ComfyUI实例（默认值： 127.0.0.1:8000).

工具

典型使用流程

1. 从PNG中提取工作流或加载已保存的工作流
2. 描述工作流程以了解其结构
3. 查看可用型号
4. 修改参数（提示、种子、模型等）
5. 执行并查看结果
6. 将输出PNG拖回ComfyUI以再现或继续迭代

PNG元数据

输出图像会自动将完整的工作流程嵌入到兼容ComfyUI的PNG元数据中。这意味着通过此服务器生成的任何图像都可以直接拖动到ComfyUI画布中，以恢复所有节点、连接和小部件值。如果您提供原始UI格式工作流（通过 ui_workflow 参数）、精确的节点位置和组标签被保留；否则，服务器将自动从API-format工作流生成干净的左右布局。

环境变量