📌Overview

Purpose: To provide a streamlined server for generating high-quality images using the Flux.1 Schnell model via Together AI, with a standardized interface for image generation parameters.

Overview: The Image Generation MCP Server facilitates the creation of images through a Model Context Protocol (MCP) server setup, allowing developers to easily integrate and customize image generation in their applications. It leverages the advanced capabilities of the Flux.1 Schnell model to ensure high-quality outputs.

Key Features:

High-Quality Image Generation: Utilizes the Flux.1 Schnell model to produce detailed and visually appealing images based on text prompts.
Customizable Dimensions: Allows users to specify the width and height of images, accommodating various requirements and ensuring flexibility in output sizes.
Clear Error Handling: Implements robust error management for prompt validation and API calling issues, making it easier for developers to troubleshoot.
Easy Integration: Designed for compatibility with MCP clients, facilitating straightforward integration into existing systems.
Optional Image Saving: Offers functionality to save generated images in PNG format to disk, enhancing usability for end-users.

Image Generation MCP Server

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

Features

High-quality image generation
Customizable dimensions (width and height)
Clear error handling for prompt validation and API issues
Easy integration with MCP-compatible clients
Image saving to disk in PNG format (optional)

Installation

To install, run:

npm install together-mcp

Or run directly:

npx together-mcp@latest

Configuration

Add to your MCP server configuration:

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<API KEY>"
      }
    }
  }
}

Usage

The server provides one tool: generate_image.

Using `generate_image`

This tool requires only one parameter - the prompt. All other parameters are optional and have sensible defaults.

Parameters

{
  prompt: string;          // Required: Text description of the image to generate
  model?: string;          // Optional: Default is "black-forest-labs/FLUX.1-schnell-Free"
  width?: number;          // Optional: Default is 1024 (min: 128, max: 2048)
  height?: number;         // Optional: Default is 768 (min: 128, max: 2048)
  steps?: number;          // Optional: Default is 1 (min: 1, max: 100)
  n?: number;              // Optional: Default is 1 (max: 4)
  response_format?: string; // Optional: Default is "b64_json"
  image_path?: string;     // Optional: Path to save the generated image as PNG
}

Request Examples

Minimal Request Example:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset"
  }
}

Full Request Example with Image Saving:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "n": 1,
    "response_format": "b64_json",
    "model": "black-forest-labs/FLUX.1-schnell-Free",
    "image_path": "/path/to/save/image.png"
  }
}

Response Format

The response will include a JSON object with details of the generated image, including:

Generation ID
Model used
Timing for inference
Base64 encoded image data or URL to generated image

If image_path was provided and the save was successful, the response will confirm the save location.

Important Notes

Only the prompt parameter is required.
All optional parameters use defaults if not provided.
Parameters must meet specified constraints.
Consider using URL format for larger images to avoid large Base64 responses.
Ensure the specified directory exists and is writable when saving images.

Prerequisites

Node.js >= 16
Together AI API key (sign up at api.together.xyz)

Dependencies

{
  "@modelcontextprotocol/sdk": "0.6.0",
  "axios": "^1.6.7"
}

Development

Clone and build the project:

git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build

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 fork the repository, create a new branch, commit your changes, and push your branch to your fork. Open a Pull Request for review. Feature requests and bug reports can be submitted via GitHub Issues.

License

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

together-mcp-server