ComfyUI MCP 服务

这是一个基于Model Context Protocol (MCP)的ComfyUI图像生成服务，通过API调用本地ComfyUI实例生成图片。

功能特性

• 通过MCP协议提供图像生成服务，实现自然语言生图自由
• 支持动态替换工作流中的提示词和尺寸等参数
• 自动加载workflows目录下的工作流文件作为资源

安装依赖

1. 确保已安装Python 3.12+

2. 使用uv管理Python环境：

• 安装uv:

  # On macOS and Linux.
  $ curl -LsSf https://astral.sh/uv/install.sh | sh
  
  # On Windows.
  $ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  
  # 更新uv(非必要操作):
  $ uv self update
  
  

测试运行服务

• uvx方式

  $ uvx hh-mcp-comfyui
  
  INFO:hh_mcp_comfyui.server:Scanning for workflows in: C:\Users\tianw\AppData\Local\uv\cache\archive-v0\dp4MTo0f1qL0DdYF_BYCL\Lib\site-packages\hh_mcp_comfyui\workflows
  INFO:hh_mcp_comfyui.server:Starting ComfyUI MCP Server...
  

• pip方式

  $ pip install hh_mcp_comfyui
  
  $ python -m hh_mcp_comfyui
  
  INFO:hh_mcp_comfyui.server:Scanning for workflows in: F:\Python\Python312\Lib\site-packages\hh_mcp_comfyui\workflows
  INFO:hh_mcp_comfyui.server:Starting ComfyUI MCP Server...
  

出现上面的信息表示服务启动成功

样例工作流copy到指定工作流目录：

点击下载获取样例工作流

（特别注意：请找你本地对应的安装目录把下载好的样例工作流添加进去，然后重启你的MCP服务，可以使用如下方式找到你的安装目录的位置）

• uvx

  $ uvx hh-mcp-comfyui
  

• pip

  #首先安装依赖
  $ pip install hh_mcp_comfyui
  $ python -m hh_mcp_comfyui
  

使用方法

必须确保本地ComfyUI实例正在运行(默认地址: http://127.0.0.1:8188) ComfyUI安装地址

Cherry Studio、Cline、Cursor等客户端的使用方式

• uvx MCP服务配置

  {
    "mcpServers": {
      "hh-mcp-comfyui": {
        "command": "uvx",
        "args": [
          "hh-mcp-comfyui"
        ]
      }
    }
  }
  

• pip MCP服务配置

  需要先执行命令窗口先执行：pip install hh_mcp_comfyui

  {
    "mcpServers": {
      "hh-mcp-comfyui": {
        "command": "python",
        "args": [
          "-m",
          "hh_mcp_comfyui"
        ]
      }
    }
  }
  

测试

使用MCP Inspector测试服务端工具

• uvx方式

  $ npx @modelcontextprotocol/inspector uvx hh-mcp-comfyui
  

• pip方式

  $ pip install hh_mcp_comfyui
  $ npx @modelcontextprotocol/inspector python -m hh_mcp_comfyui
  

使用注意事项（针对没有用过comfyui的特别注意）

• 默认工作流为t2image_bizyair_flux
• 图片尺寸默认为1024x1024
• 服务启动时会自动加载workflows目录下的所有JSON工作流文件
• 如果你使用的是本项目中的样例工作流需要在comfyui中下载个插件，详细操作请查看：样例工作流插件安装教程
• 如果使用你本地的comfyui工作流的话，先要保证你的工作流能在comfyui正常运行，然后需要导出(API)的JSON格式，并放入workflows目录中

如有问题可以到微信公众号中联系我：