pplate/pi_mcps
1
1
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects 1 Releases Wiki Activity
Page: mcp-image-gen
Pages
BigMind CannaManage 01 Charter CannaManage 02 UserStories CannaManage 03 Architecture CannaManage 04 Flowcharts CannaManage 05 API CannaManage 06 Wireframes CannaManage 07 CodingStandards CannaManage 08 TestPlan CannaManage 09 Deployment CannaManage 10 Retrospective CannaManage Home Development Conventions Home Java Architecture Java Projects Java mss failsafe Java wellmann shop MCP-Servers-Overview MCP Servers Overview mcp image gen ComfyUI Setup mcp-image-gen mcp image gen mcp-webscraper mcp webscraper mss-failsafe wellmann-shop
Clone
1
mcp-image-gen
pplate edited this page 2026-04-04 14:34:45 +02:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

🎨 mcp-image-gen — AI Image Generation

Image Gen Banner

mcp-image-gen is a FastMCP server that wraps the ComfyUI REST API, enabling Roo Code and Claude Desktop to generate images directly from text prompts using FLUX.1-schnell running on an AMD RX 7900 XTX GPU.

Architecture

Roo Code / Claude Desktop
  │ MCP (stdio)
  ▼
mcp-image-gen (FastMCP, Python 3.11+)
  │ HTTP REST
  ▼
ComfyUI @ localhost:8188
  │ ROCm / HSA_OVERRIDE_GFX_VERSION=11.0.0
  ▼
FLUX.1-schnell (~8s/image @ 1024×1024)

Tools

Tool Description
generate_image Generate PNG from text prompt; returns file path + inline base64
list_available_models List ComfyUI checkpoint models
get_generation_status Check status of a queued/running job
get_output_directory Return configured output directory path

Key Parameters — generate_image

Parameter Default Description
prompt required Text description of the image
width 1024 Image width in pixels
height 1024 Image height in pixels
steps 4 Inference steps (FLUX.1-schnell is 4-step)
model flux1-schnell.safetensors Model checkpoint name
seed -1 (random) Generation seed for reproducibility
negative_prompt "" Things to avoid in the image
output_dir ~/Pictures/mcp-generated Where to save output PNG

Environment Variables

Variable Default Description
COMFYUI_URL http://localhost:8188 ComfyUI API endpoint
IMAGE_OUTPUT_DIR ~/Pictures/mcp-generated Default output directory
COMFYUI_TIMEOUT 120 Request timeout in seconds

Return Value

The tool returns two content items:

  1. TextContent — file path, seed used, elapsed time
  2. ImageContent — base64-encoded PNG (displays inline in Roo Code chat)

⚠️ Known FastMCP Bug: Never use fastmcp.utilities.types.Image as return type — it breaks serialization in FastMCP 3.x. Use mcp.types.ImageContent directly.

Quick Start

cd mcp/mcp-image-gen
uv sync
./run.sh

Run Tests

cd mcp/mcp-image-gen
uv run pytest tests/ -v

Lumen Profile Images

The first images generated with this server were Lumen's visual identity portraits:

Lumen Profile

Primary profile: seed 568659042 — constellation face interpretation of Lumen.

ComfyUI Setup

See mcp-image-gen-ComfyUI-Setup for full installation instructions including AMD ROCm setup.

🔧 pi_mcps Wiki

Overview

MCP Servers

Java Projects

🌿 CannaManage

Gitea Repo