Skip to main content

MCP server enabling Image Generation for LLMs, built in Python and integrated with Together AI.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mseep_image_gen-0.1.1.tar.gz (11.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_image_gen-0.1.1-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file mseep_image_gen-0.1.1.tar.gz.

File metadata

  • Download URL: mseep_image_gen-0.1.1.tar.gz
  • Upload date:
  • Size: 11.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for mseep_image_gen-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a9a65a4cd9a25574d08447f53563d1fbe09abae08409db33234aa6b01d0cc83a
MD5 41e7dc6d574779febe78ee472cf3f9e0
BLAKE2b-256 dd599c9170c1201b9eb1d635838a084886789242805b7cd9f203d72229648492

See more details on using hashes here.

File details

Details for the file mseep_image_gen-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_image_gen-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ecc62eca36f9c6fbd1c490f917b1a61369c2dc7cedbc8be25fbae8ea58465b7a
MD5 20c385126b236a923733c256052aeed7
BLAKE2b-256 f9806b8e7f51c21edf33d6b7e73afa083bf7c8822b98ece546f078e2ecff7399

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page