mcp-fooocus-api

# MCP Fooocus API A Model Context Protocol (MCP) server that provides text-to-image generation capabilities through the Fooocus Stable Diffusion API. ## Features - **Text-to-Image Generation**: Generate high-quality images from text prompts - **Intelligent Style Selection**: Automatically selects 1-3 appropriate styles based on your prompt - **Custom Style Override**: Manually specify styles from 300+ available options - **Multiple Performance Modes**: Choose between Speed, Quality, and Extreme Speed - **Configurable Aspect Ratios**: Support for various image dimensions - **Environment-based Configuration**: Easy API endpoint configuration via `.env` file ## Installation ### Using uv (Recommended) Install directly from GitHub: ```bash uv add git+https://github.com/raihan0824/mcp-fooocus-api.git ``` Or install from PyPI (when published): ```bash uv add mcp-fooocus-api ``` Run with uvx: ```bash uvx --from git+https://github.com/raihan0824/mcp-fooocus-api.git mcp-fooocus-api ``` ### Using pip ```bash pip install git+https://github.com/raihan0824/mcp-fooocus-api.git ``` Or from PyPI (when published): ```bash pip install mcp-fooocus-api ``` ### Development Installation ```bash # Clone the repository git clone https://github.com/raihan0824/mcp-fooocus-api.git cd mcp-fooocus-api # Install with uv uv sync --dev # Or install with pip pip install -e ".[dev]" ``` ## Configuration 1. Copy the example environment file: ```bash cp .env.example .env ``` 2. Edit the `.env` file to configure your Fooocus API endpoint: ```bash FOOOCUS_API_URL=http://103.125.100.56:8888/v1/generation/text-to-image ``` ## Usage ### Available Tools The MCP server provides three main tools: #### 1. `generate_image` Generate an image using the Fooocus API. **Parameters:** - `prompt` (required): Text description of the image to generate - `performance` (optional): Performance setting - "Speed" (default), "Quality", or "Extreme Speed" - `custom_styles` (optional): Comma-separated lis…