MCP Imagegen

🚀 MCP Image Generator

An MCP (Model Context Protocol) server for generating images using Together AI's image generation models. This MCP server can run locally or via an SSE endpoint.

The MCP Image Generator requires a provider to be specified. Currently, only "Replicate" and "Together" are supported. You need to set the TOGETHER_API_KEY or REPLICATE_API_TOKEN environment variables and set the PROVIDER environment variable to "replicate" or "together".

🚀 Quick Start

SSE Endpoint (Docker Environment)

Clone the Repository

git clone https://github.com/gmkr/mcp-imagegen.git
cd mcp-imagegen

Build and Run the Docker Container

docker build -f Dockerfile.server -t mcp-imagegen .
docker run -p 3000:3000 mcp-imagegen

Configure with an MCP Client

{
  "mcpServers": {
    "imagegenerator": {
      "url": "http://localhost:3000/sse",
      "env": {
        "PROVIDER": "replicate",
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      }
    }
  }
}

Adjust the url to the MCP server endpoint you are using. The provider can be "replicate" or "together".

Local Environment (Based on Standard Input/Output)

Prerequisites

• Node.js
• Together AI API key or Replicate API access token

Install Dependencies

git clone https://github.com/gmkr/mcp-imagegen.git
cd mcp-imagegen
pnpm install

Configuration

Create a configuration file for your MCP client, for example:

{
  "mcpServers": {
    "imagegenerator": {
      "command": "pnpx",
      "args": [
        "-y",
        "tsx",
        "/path/to/mcp-imagegen/src/index.ts"
      ],
      "env": {
        "PROVIDER": "replicate",
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      }
    }
  }
}

Replace /path/to/mcp-imagegen with the actual path where you cloned the repository, and replace your-replicate-api-token with your actual Replicate API access token.

💻 Usage Examples

Tool: generate_image

Generate an image based on the provided prompt.

Parameters:

• prompt (string): The text prompt for image generation.
• width (number, optional): The width of the generated image (default: 512).
• height (number, optional): The height of the generated image (default: 512).
• numberOfImages (number, optional): The number of images to generate (default: 1).

🔧 Technical Details

Environment Variables

• PROVIDER: The provider for image generation (default: "replicate").
• REPLICATE_API_TOKEN: Your Replicate API access token.
• TOGETHER_API_KEY: Your Together AI API key.
• MODEL_NAME: The name of the model for image generation (default: "black-forest-labs/flux-schnell").

📄 License

MIT