Fooocus

You run an MCP server that exposes Fooocus text-to-image generation via a Fooocus API endpoint. This server automates style selection, supports custom styles, multiple performance modes, and configurable image sizes, all accessible through your MCP client.

How to use

You interact with the server through your MCP client by using the available tools to generate images, discover supported styles, and inspect server details.

How to install

Prerequisites: You need Python 3.8+ on your machine. If you plan to run via the MCP client setup, you will also use the MCP command runner.

1. Install directly from source using the MCP workflow:

uv add git+https://github.com/raihan0824/mcp-fooocus-api.git

2. Install from PyPI (when published):

uv add mcp-fooocus-api

3. Run with uvx (standalone or as part of MCP client):

uvx --from git+https://github.com/raihan0824/mcp-fooocus-api.git mcp-fooocus-api

4. Development installation (optional):

# 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 and usage notes

Configure the endpoint your server will call by setting an environment variable pointing to the Fooocus API URL.

FOOOCUS_API_URL=http://103.125.100.56:8888/v1/generation/text-to-image

Additional setup for running as an MCP server

To run as an MCP server you can configure the MCP client to point to the local or remote server and specify how it should be started.

Security and maintenance notes

Keep your Fooocus API endpoint secure and accessible only by trusted clients. Regularly update the MCP server and its dependencies to benefit from security fixes and new features.

Troubleshooting tips

If you encounter connection issues, verify that the Fooocus API URL is reachable from the host running the MCP server and that the API key or access method matches what Fooocus requires.

Embeddable end-user actions

You can request image generation, list available styles, or fetch server information through your MCP client using the server’s three main tools.

Available tools

generate_image

Generates an image from a text prompt with options for performance, custom styles, and aspect ratio.

list_available_styles

Returns all available styles categorized by groups such as Fooocus, SAI, Art Styles, Photography, and more.

get_server_info

Provides server version, name, configured API endpoint, supported features, and performance options.