Comfyui MCP Server

🚀 ComfyUI MCP 服務端

ComfyUI MCP 服務端是一個用於將 ComfyUI 集成到 MCP 中的服務實現，可幫助用戶更便捷地使用相關功能。不過，此服務需要運行中的 ComfyUI 服務器支持。

🚀 快速開始

此服務需要運行中的 ComfyUI 服務器，您必須自行搭建一個 ComfyUI 服務器，或者擁有訪問現有 ComfyUI 服務器地址的權限。

✨ 主要特性

• 可將 ComfyUI 集成到 MCP 中。
• 提供了多種內置工具，如文本轉圖像、下載圖像等。
• 支持添加自定義工作流程。

📦 安裝指南

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 服務器地址的權限。