mcp-image-gen

MCP.Pizza Chef: sarthakkimtani

The mcp-image-gen is a Python-based MCP server that enables high-quality image generation through Together AI's Flux.1 Schnell model. It offers a standardized interface for specifying image generation parameters such as width and height, ensuring flexible and customizable outputs. Designed for easy integration with MCP-compatible clients, it includes robust error handling for prompt validation and API issues, making it reliable for real-time AI workflows. This server empowers LLMs to generate images seamlessly within their environment, enhancing multimodal AI applications.

Use This MCP server To

Generate custom images from text prompts in AI workflows Integrate image creation into chatbots and virtual assistants Produce visuals for content generation and marketing Create images with specific dimensions for design projects Enable real-time image generation in AI-powered apps

README

Image Generation MCP Server

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

Image Generation Server MCP server

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

Installation

Claude Desktop

  • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
{
  "mcpServers": {
    "image-gen": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/image-gen/", "run", "image-gen"],
      "env": {
        "TOGETHER_AI_API_KEY": "<API KEY>"
      }
    }
  }
}

Available Tools

The server implements one tool:

generate_image

Generates an image based on the given textual prompt and optional dimensions.

Input Schema:

{
  "prompt": {
    "type": "string",
    "description": "A descriptive prompt for generating the image (e.g., 'a futuristic cityscape at sunset')"
  },
  "width": {
    "type": "integer",
    "description": "Width of the generated image in pixels (optional)"
  },
  "height": {
    "type": "integer",
    "description": "Height of the generated image in pixels (optional)"
  },
  "model": {
    "type": "string",
    "description": "The exact model name as it appears in Together AI. If incorrect, it will fallback to the default model (black-forest-labs/FLUX.1-schnell)."
  }
}

Prerequisites

  • Python 3.12 or higher
  • httpx
  • mcp

Contributing

Contributions are welcome! Please follow these steps to contribute:

  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

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.

mcp-image-gen FAQ

How do I install the mcp-image-gen server?
Installation involves configuring the server in your MCP client, such as Claude Desktop, by editing the configuration JSON file on MacOS or Windows as specified in the documentation.
What image generation model does mcp-image-gen use?
It uses the Flux.1 Schnell model provided by Together AI for high-quality image generation.
Can I customize the size of generated images?
Yes, the server supports customizable width and height parameters for image generation.
How does mcp-image-gen handle errors?
It provides clear error handling for prompt validation issues and API-related problems to ensure reliable operation.
Is mcp-image-gen compatible with multiple MCP clients?
Yes, it is designed for easy integration with any MCP-compatible client, enabling flexible deployment.
Does mcp-image-gen support real-time image generation?
Yes, it supports real-time generation of images as part of AI workflows.
What programming language is mcp-image-gen built with?
The server is built in Python, facilitating easy customization and extension.
Can mcp-image-gen be used with LLMs from providers like OpenAI, Claude, and Gemini?
Yes, it integrates seamlessly with LLMs from OpenAI, Claude, Gemini, and other providers via the MCP protocol.