STARWARCLOUD STARWAR.AI
返回市场
hh-mcp-舒适的ui服务器

hh-mcp-舒适的ui服务器

作者：zjf267116 星标更新：2025-07-12
安装使用来源：spider==github.com

项目介绍

【技术文档摘要】： MseeP.ai 安全评估徽章

ComfyUI MCP 服务

英文 简体中文 Python 3.12+ 许可证 smithery 徽章

这是一个基于模型上下文协议（MCP）的ComfyUI图像生成服务，通过API调用本地的ComfyUI实例来生成图像。

功能特性

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

新功能记录

  • [2025-06-29] 支持Kontext图像编辑工作流程 edit-image-85457440acc11a9f386f8ef284fd62f2.jpg
  • [2025-05-11] 支持动态配置工作流程文件目录
  • [2025-05-09] 增加了Docker构建方法，支持Python 3.12+
  • [2025-05-07] 添加了pip构建方法
  • [2025-05-06] 更改项目目录从src/hh到src/hh_mcp_comfyui，并添加了uvx构建方法
  • [2025-04-26] 增加了图像到图像和背景移除样本工作流程，并支持图像到图像工具
  • [2025-04-20] 添加了文本到图像生成工具

效果

  • 在Cherry Studio中的使用 image-b8f946109d63fe1ccb5e2d63933e3f9e.png

  • 在Cline中的使用 cline_gen_image-48d8515e0b59cd313879c62a1546162d.png ComfyUI_00020_-d9171f87fc9e67fcc1966cdbfb952a0c.png

安装依赖

确保已安装Python 3.12+

2. 使用uv管理Python环境：

  • 安装uv： 
    # 在macOS和Linux上。
$ curl -LsSf https://astral.sh/uv/install.sh | sh

# 在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:正在扫描工作流程：C:\Users\tianw\AppData\Local\uv\cache\archive-v0\dp4MTo0f1qL0DdYF_BYCL\Lib\site-packages\hh_mcp_comfyui\workflows
INFO:hh_mcp_comfyui.server:启动ComfyUI MCP服务器...
  • pip方法 
    $ pip install hh_mcp_comfyui

$ python -m hh_mcp_comfyui

INFO:hh_mcp_comfyui.server:正在扫描工作流程：F:\Python\Python313\Lib\site-packages\hh_mcp_comfyui\workflows
INFO:hh_mcp_comfyui.server:启动ComfyUI MCP服务器...

以上消息表示服务已成功启动

使用说明

您必须确保本地的ComfyUI实例正在运行（默认地址：http://127.0.0.1:8188）[ComfyUI安装地址](https://github.com/comfyanonymous/ComfyUI.git)

如何在Cherry Studio、Cline和Cursor等客户端应用中使用

<details> <summary>uvx MCP服务配置</summary> 
{
  "mcpServers": {
    "hh-mcp-comfyui": {
      "command": "uvx",
      "args": [
        "hh-mcp-comfyui@latest"
      ],
      "env": {
        "COMFYUI_API_BASE": "http://127.0.0.1:8188",
        "COMFYUI_WORKFLOWS_DIR": "/path/hh-mcp-comfyui/workflows"
      }
    }
  }
}
</details> <details> <summary>pip MCP服务配置</summary>

您需要先在命令窗口执行以下命令：pip install hh_mcp_comfyui

{
  "mcpServers": {
    "hh-mcp-comfyui": {
      "command": "python",
      "args": [
        "-m",
        "hh_mcp_comfyui"
      ],
      "env": {
        "COMFYUI_API_BASE": "http://127.0.0.1:8188",
        "COMFYUI_WORKFLOWS_DIR": "/path/hh-mcp-comfyui/workflows"
      }
    }
  }
}
</details> <details> <summary>Docker MCP服务配置</summary>

前提条件是已经安装了Docker

{
  "mcpServers": {
    "hh-mcp-comfyui": {
      "command": "docker",
      "args": [
          "run",
          "--net=host",
          "-v",
          "/path/hh-mcp-comfyui/workflows:/app/workflows",
          "-i",
          "--rm",
          "zjf2671/hh-mcp-comfyui:latest"
      ],
      "env": {
        "COMFYUI_API_BASE": "http://127.0.0.1:8188"
      }
    }
  }
}
</details>

将样本工作流程复制到指定的工作流程目录：

---注意使用下面的uvx或pip方法找到您的安装工作流程目录，添加样本工作流程，然后重新启动您的MCP服务

  • uvx

    $ uvx hh-mcp-comfyui

    image-2-f89caf964efbccdad7b6fa2672d1cac0.png

  • pip

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

    image-3-03a069f40492fea9947a351b8707aa3f.png

测试

使用MCP Inspector测试服务器端工具

  • UVX模式 
    $ npx @modelcontextprotocol/inspector uvx hh-mcp-comfyui
  • pip方法 
    $ pip install hh_mcp_comfyui
$ npx @modelcontextprotocol/inspector python -m hh_mcp_comfyui
  • Docker方法 
    $ npx @modelcontextprotocol/inspector docker run --net=host -i --rm zjf2671/hh-mcp-comfyui

然后点击图中所示的连接进行调试： image-1-44c6a003ee317093afe5a61cfe028720.png

使用注意事项（特别提醒未使用过ComfyUI的人）

  • 默认工作流程是t2image_bizyair_flux
  • 默认图像大小是1024x1024
  • 当服务启动时，会自动加载工作流程目录中的所有JSON工作流程文件
  • 如果您使用的是本项目中的样本工作流程，则需要在ComfyUI中下载一个插件。具体步骤请参阅：样本工作流程插件安装教程
  • 如果您使用的是本地的ComfyUI工作流程，请先确保该工作流程可以在ComfyUI中正常运行，然后以JSON格式导出（API），并放置在本地目录/path/hh-mcp-comfyui/workflows中

添加新的工作流程

  1. 将工作流程JSON文件放置在/path/hh-mcp-comfyui/workflows目录中

    如果是使用uvx和pip启动方法，请参考上面的将样本工作流程复制到指定的工作流程目录部分

  2. 重启服务以自动加载新的工作流程

开发

项目结构

.
├── .gitignore
├── .python-version
├── pyproject.toml
├── README.md
├── uv.lock
├── example/              # 示例工作流目录
│   └── workflows/
│       ├── i2image_bizyair_sdxl.json
│       ├── t2image_bizyair_flux.json
│       ├── i2image_cogview4.json
│       └── t2image_sd1.5.json
├── src/                  # 源代码目录
│   └── hh_mcp_comfyui/
│       ├── comfyui_client.py    # ComfyUI客户端实现
│       ├── server.py            # MCP服务主文件
│       └── workflows/           # 工作流文件目录

初始化项目开发环境：

# 克隆仓库。
$ git clone https://github.com/zjf2671/hh-mcp-comfyui.git

$ cd hh-mcp-comfyui

# 初始化虚拟环境。
$ uv venv

# 激活虚拟环境。
$ .venv\Scripts\activate

# 安装依赖。
$ uv lock
Resolved 30 packages in 1ms

# 同步依赖。
$ uv sync
Resolved 30 packages in 2.54s
Audited 29 package in 0.02ms

检查服务是否正常运行

$ uv --directory 你本地安装目录/hh-mcp-comfyui run hh-mcp-comfyui

INFO:__main__:正在扫描工作流程：D:\cygitproject\hh-mcp-comfyui\src\hh_mcp_comfyui\workflows
INFO:__main__:注册资源：workflow://t2image_bizyair_flux -> t2image_bizyair_flux.json
INFO:__main__:启动ComfyUI MCP服务器...

使用MCP Inspector测试服务器端工具

$ npx @modelcontextprotocol/inspector uv --directory 你本地安装目录/hh-mcp-comfyui run hh-mcp-comfyui

MCP配置

{
  "mcpServers": {
    "hh-mcp-comfyui": {
      "command": "uv",
      "args": [
        "--directory",
        "项目绝对路径（例如：D:/hh-mcp-comfyui）",
        "run",
        "hh-mcp-comfyui"
      ],
      "env": {
        "COMFYUI_API_BASE": "http://127.0.0.1:8188",
        "COMFYUI_WORKFLOWS_DIR": "/path/hh-mcp-comfyui/workflows"
      }
    }
  }
}

贡献

  1. 分叉项目
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开Pull Request

如果有任何疑问，可以通过官方账号联系我们：

<center>公众号二维码</center>

<center><u>👆 扫码关注，发现更多好玩的！</u></center>