ComfyUI MCP Server

AI-powered image generation for Godot game development via ComfyUI

Overview

ComfyUI MCP Server is a Model Context Protocol (MCP) server that bridges ComfyUI's workflow-based AI image generation with Godot game development. Generate game assets dynamically during development or runtime.

Features

• MCP Integration: Expose ComfyUI workflows as MCP tools

• Workflow Templates: Pre-built templates for common game assets

• Async Operations: Non-blocking generation with real-time progress updates

• Godot Support: Seamless integration with Godot 3.x and 4.x

• Flexible Configuration: Environment variables and config files

Use Cases

• Character Generation: NPC portraits, character sprites

• Item Icons: Unique item icons based on descriptions

• Environment Art: Background textures, tileable patterns

• Dynamic Content: Procedural asset generation on-the-fly

• Concept Art: Rapid prototyping and visual development

Quick Start

Prerequisites

• Python 3.10 or higher

• ComfyUI installed and running on http://127.0.0.1:8188

• Stable Diffusion models downloaded and available in ComfyUI

Installation

Configuration

Create or update your .mcp.json configuration file:

Usage

MCP Tools

• generate_image: Generate images using ComfyUI workflows

• list_workflows: List available workflow templates

• get_workflow_status: Check the status of a running workflow

• cancel_workflow: Cancel a running workflow

• load_workflow: Load a custom workflow from file

Example: Generate Character Portrait

Development

Setup Development Environment

Project Structure

Documentation

• Quick Start Guide (coming soon)

• Godot Integration Guide (coming soon)

• Workflow Template Format (coming soon)

• API Documentation (coming soon)

• Contributing Guide (coming soon)

Workflow Templates

Pre-built templates for common game assets:

• character-portrait: Character portraits for RPGs (SD 1.5 base)

• item-icon: Item icons (512x512, centered)

• environment-texture: Tileable environment textures

• pixel-art: Pixel art generation (upscale + pixelate)

See workflows/ directory for template files.

Examples

Explore examples/ for Godot integration samples:

• Character portrait generation for RPG

• Item icon batch generation

• Environment texture generation

• Real-time generation in Godot

• Procedural sprite variation

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

Development Workflow

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Make your changes

4. Run tests and quality checks

5. Commit your changes (git commit -m 'feat: add amazing feature')

6. Push to the branch (git push origin feature/amazing-feature)

7. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• ComfyUI - Powerful workflow-based Stable Diffusion UI

• Godot Engine - Open-source game engine

• Model Context Protocol - Universal AI integration standard

Support

• Issues: GitHub Issues

• Discussions: GitHub Discussions

Roadmap

See CHANGELOG.md and GitHub Milestones for upcoming features.

Status: Alpha - Active Development

Built with by Purlieu Studios