Image Generation MCP Server

A Model Context Protocol (MCP) server that enables seamless generation of high-quality images using the Flux.1 Schnell model via Together AI. This server provides a standardized interface to specify image generation parameters.

Features

• High-quality image generation powered by the Flux.1 Schnell model

• Support for customizable dimensions (width and height)

• Clear error handling for prompt validation and API issues

• Easy integration with MCP-compatible clients

• Optional image saving to disk in PNG format

Related MCP server: Image Generation MCP Server

Installation

Or run directly:

Configuration

Add to your MCP server configuration:

Usage

The server provides one tool: generate_image

Using generate_image

This tool has only one required parameter - the prompt. All other parameters are optional and use sensible defaults if not provided.

Parameters

Minimal Request Example

Only the prompt is required:

Full Request Example with Image Saving

Override any defaults and specify a path to save the image:

Response Format

The response will be a JSON object containing:

If image_path was provided and the save was successful, the response will include confirmation of the save location.

Default Values

If not specified in the request, these defaults are used:

• model: "black-forest-labs/FLUX.1-schnell-Free"

• width: 1024

• height: 768

• steps: 1

• n: 1

• response_format: "b64_json"

Important Notes

1. Only the prompt parameter is required

2. All optional parameters use defaults if not provided

3. When provided, parameters must meet their constraints (e.g., width/height ranges)

4. Base64 responses can be large - use URL format for larger images

5. When saving images, ensure the specified directory exists and is writable

Prerequisites

• Node.js >= 16

• Together AI API key

  1. Sign in at api.together.xyz

  2. Navigate to API Keys settings

  3. Click "Create" to generate a new API key

  4. Copy the generated key for use in your MCP configuration

Dependencies

Development

Clone and build the project:

Available Scripts

• npm run build - Build the TypeScript project

• npm run watch - Watch for changes and rebuild

• npm run inspector - Run MCP inspector

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository

2. Create a new branch (feature/my-new-feature)

3. Commit your changes

4. Push the branch to your fork

5. Open a Pull Request

Feature requests and bug reports can be submitted via GitHub Issues. Please check existing issues before creating a new one.

For significant changes, please open an issue first to discuss your proposed changes.

License

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