fm-mcp-comfyui-bridge

🌟 基本能力

产品定位

fm-mcp-comfyui-bridge 是一个用于访问 ComfyUI 的 MCP 服务器实现，提供与 ComfyUI API 的集成，支持图像生成、图像标注生成和图像标签解析等功能。

核心功能

• 🖼️ ComfyUI 利用した画像生成機能
• 📝 生成画像のキャプション生成機能
• 🏷️ 生成画像のタグ解析機能
• 🔄 uv による簡単なセットアップと起動
• 🌐 MCP サーバーとして API エンドポイントを提供

适用场景

• 图像生成与处理
• 图像标注生成
• 图像标签解析

工具列表

1. generate_picture - 根据提示生成图像
2. get_picture - 获取指定图像的 PNG 二进制数据
3. get_caption - 获取图像的文本标注
4. get_tag - 解析图像的 WD1.4 标签

常见问题解答

• 确保 Python 3.13 以上版本
• 确保本地运行的 ComfyUI（默认: http://localhost:8188）
• 确保安装了 uv 包管理器
• 确保本地运行的 ollama 和可用的 vision 模型

🔧 使用教程

使用依赖

• Python 3.13 以上
• 本地运行的 ComfyUI（默认: http://localhost:8188）
• uv 包管理器
• 本地运行的 ollama 和可用的 vision 模型

安装教程

# 克隆仓库
git clone https://github.com/rerofumi/fm-mcp-comfyui-bridge.git
cd fm-mcp-comfyui-bridge

# 使用 uv 安装依赖
uv pip install -e .

调试方式

1. 确保 ComfyUI 的 workflow 正常运行
2. 检查 src\fm_mcp_comfyui_bridge\config\workflow\ 下的 json 文件是否在 ComfyUI 中加载无误
3. 确保所有自定义节点已安装

🚀 使用方法

MCP 服务器设置

在代理工具的 MCP 设置中添加以下配置：

{
  "mcpServers": {
    "fm-mcp-comfyui-bridge": {
      "command": "uv",
      "args": [
        "--directory",
        "(安装目录)/fm-mcp-comfyui-bridge",
        "run",
        "fm-mcp-comfyui-bridge"
      ]
    }
  }
}

ComfyUI 端点设置

默认 ComfyUI 端点为 http://localhost:8188，可在 main.py 中修改。

Lora 设置

1. 复制示例配置文件：

cp src/fm_mcp_comfyui_bridge/config/sample_config.yaml src/fm_mcp_comfyui_bridge/config/config.yaml

1. 编辑 config.yaml 文件，设置模型参数。

ollama 设置

编辑 ollama.yaml 文件，设置 vision 模型名称。

自定义 workflow

将自定义 workflow 文件放入 src\fm_mcp_comfyui_bridge\config\workflow\ 目录下，系统将自动加载。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。