comfyui-mcp-server

🚀 ComfyUI MCP 服务端

ComfyUI MCP 服务端是一个用于将 ComfyUI 集成到 MCP 中的服务实现，可帮助用户更便捷地使用 ComfyUI 相关功能。

🚀 快速开始

此服务需要运行中的 ComfyUI 服务器，您必须自行搭建一个 ComfyUI 服务器，或者拥有访问现有 ComfyUI 服务器地址的权限。

✨ 主要特性

• 可将 ComfyUI 集成到 MCP 中。
• 提供多种内置工具，如 text_to_image、download_image 等。
• 支持添加自定义工作流程作为新工具。

📦 安装指南

ComfyUI 配置

修改 src/.env 文件以设置 ComfyUI 主机和端口：

COMFYUI_HOST=localhost
COMFYUI_PORT=8188

添加自定义工作流程

要添加新的工具，请将您的工作流程 JSON 文件放入 workflows 目录，并在系统中声明它们为新工具。

💻 使用示例

基础用法

ComfyUI 调试

python src/test_comfyui.py

MCP 调试

mcp dev src/server.py

高级用法

使用 UV 运行

# 示例命令：运行 ComfyUI MCP 服务端

使用 Docker 部署

构建 Docker 镜像

# 假设 Dockerfile 内容如下：
FROM python:3.x
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8001
CMD ["python", "server.py"]

构建并运行

docker build -t comfyui-mcp-server .
docker run -p 8001:8001 --gpus=all comfyui-mcp-server

📚 详细文档

内置工具

text_to_image

• 返回生成图像的 URL。
• 要获取实际图像：
  • 使用 download_image 工具，或
  • 直接通过浏览器访问该 URL。
• 示例图（类似 CursorAI 的效果）：

download_image

下载由其他工具生成的图像（例如 text_to_image）使用其 URL。

添加新工作流程作为工具

• 将新的工作流程 JSON 文件放在 workflows 目录中。
• 在系统中声明该文件为一个新的工具。

🔧 技术细节

注意事项

当添加新的工作流程作为工具时，需要重新构建并重新部署 Docker 镜像，以确保新工具能够生效。

重要提示

⚠️ 重要提示

此服务需要运行中的 ComfyUI 服务器，您必须自行搭建一个 ComfyUI 服务器，或者拥有访问现有 ComfyUI 服务器地址的权限。