Comfyui MCP Server

🚀 ComfyUI MCP Server

A service implementation for integrating ComfyUI into MCP. This service enables seamless interaction between ComfyUI and MCP.

🚀 Quick Start

This service is designed to integrate ComfyUI into MCP. However, it requires a running ComfyUI server. You need to either set up your own ComfyUI server or have access to an existing one.

✨ Features

• Integrate ComfyUI into MCP.
• Provide built - in tools such as text_to_image and download_image.
• Support adding new workflows as tools.

📦 Installation

ComfyUI Configuration

Modify the src/.env file to set the ComfyUI host and port:

COMFYUI_HOST=localhost
COMFYUI_PORT=8188

Adding Custom Workflows

To add new tools, place your workflow JSON files in the workflows directory and declare them as new tools in the system.

💻 Usage Examples

Basic Usage

ComfyUI Debugging

python src/test_comfyui.py

MCP Debugging

mcp dev src/server.py

Advanced Usage

Running with UV

# Example command: Run the ComfyUI MCP server

Deploying with Docker

Build the Docker Image

# Assume the Dockerfile content is as follows:
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"]

Build and Run

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

📚 Documentation

Built - in Tools

• text_to_image

  • Returns the URL of the generated image.
  • To get the actual image:
    • Use the download_image tool, or
    • Access the URL directly through a browser.
  • Example image (similar to CursorAI effect):

• download_image

  • Downloads an image generated by other tools (e.g., text_to_image) using its URL.

• Adding New Workflows as Tools

  • Place the new workflow JSON file in the workflows directory.
  • Declare the file as a new tool in the system.

Precautions

When adding a new workflow as a tool, you need to rebuild and redeploy the Docker image to ensure that the new tool takes effect.

📄 License

No license information provided in the original README.

⚠️ Important Note

This service requires a running ComfyUI server. You must either set up your own ComfyUI server or have access to an existing ComfyUI server address.