Comfy MCP Server
@lalanikarim
A server using FastMCP framework to generate images based on prompts via a remote Comfy server.
Overview
What is Comfy MCP Server?
Comfy MCP Server uses the FastMCP framework to generate images based on prompts via a remote Comfy server. It submits prompts to a Comfy server and retrieves generated images.
How to use Comfy MCP Server?
Set the required environment variables (COMFY_URL, COMFY_WORKFLOW_JSON_FILE, PROMPT_NODE_ID, OUTPUT_NODE_ID, OUTPUT_MODE) and optionally OLLAMA_API_BASE and PROMPT_LLM. Launch the server with uvx comfy-mcp-server. Configure it in Claude Desktop by adding the command and environment variables to the MCP server configuration.
Key features of Comfy MCP Server
generate_image(prompt, ctx)submits a prompt and returns the generated image.generate_prompt(topic, ctx)creates an image generation prompt from a topic.- Supports optional Ollama integration for prompt generation.
- Works with any exported ComfyUI workflow JSON file.
- Outputs images as URLs or local files via
OUTPUT_MODE.
Use cases of Comfy MCP Server
- Generate images from text prompts using a remote Comfy server.
- Automatically enrich a topic into a detailed image-generation prompt via Ollama.
- Integrate image generation into MCP clients like Claude Desktop.
- Use custom ComfyUI workflows without modifying the server code.
FAQ from Comfy MCP Server
What does the server do?
It generates images by sending prompts to a remote Comfy server and retrieving the results.
What prerequisites are needed?
You need uv (Python package manager), a Comfy server URL, and an exported workflow JSON file from ComfyUI.
How do I configure the environment variables?
Set COMFY_URL, COMFY_WORKFLOW_JSON_FILE, PROMPT_NODE_ID, OUTPUT_NODE_ID, and OUTPUT_MODE. Optionally set OLLAMA_API_BASE and PROMPT_LLM for prompt generation via Ollama.
Is Ollama required?
No, Ollama is optional. The server can generate images without it, but if Ollama is available it can be used to turn a topic into a detailed prompt.
What output formats are supported?
The server supports two modes via OUTPUT_MODE: url to return an image URL, or file to return the image as a file.
