Image Generation

Image Generation MCP Server

This MCP server provides image generation capabilities using the Replicate Flux model.

Installation

Option 1: NPX Method (No Local Setup Required)

You can use the package directly from npm without installing it locally:

1# No installation needed - npx will handle it

Option 2: Local Installation

If you prefer a local installation:

1# Global installation
2npm install -g @gongrzhe/image-gen-server
3
4# Or local installation
5npm install @gongrzhe/image-gen-server

Setup

Configure Claude Desktop

Edit your Claude Desktop configuration file:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

Option 1: NPX Configuration (Recommended)

This method runs the server directly from npm without needing local files:

1{
2  "mcpServers": {
3    "image-gen": {
4      "command": "npx",
5      "args": ["@gongrzhe/image-gen-server"],
6      "env": {
7        "REPLICATE_API_TOKEN": "your-replicate-api-token",
8        "MODEL": "alternative-model-name"
9      },
10      "disabled": false,
11      "autoApprove": []
12    }
13  }
14}

Option 2: Local Installation Configuration

If you installed the package locally:

1{
2  "mcpServers": {
3    "image-gen": {
4      "command": "node",
5      "args": ["/path/to/image-gen-server/build/index.js"],
6      "env": {
7        "REPLICATE_API_TOKEN": "your-replicate-api-token",
8        "MODEL": "alternative-model-name"
9      },
10      "disabled": false,
11      "autoApprove": []
12    }
13  }
14}

Get Your Replicate API Token

Sign up/login at https://replicate.com
Go to https://replicate.com/account/api-tokens
Create a new API token
Copy the token and replace your-replicate-api-token in the MCP settings

Environment Variables

REPLICATE_API_TOKEN (required): Your Replicate API token for authentication
MODEL (optional): The Replicate model to use for image generation. Defaults to "black-forest-labs/flux-schnell"

Configuration Parameters

disabled: Controls whether the server is enabled (false) or disabled (true)
autoApprove: Array of tool names that can be executed without user confirmation. Empty array means all tool calls require confirmation.

Available Tools

generate_image

Generates images using the Flux model based on text prompts.

out-0 (1)

Parameters

prompt (required): Text description of the image to generate
seed (optional): Random seed for reproducible generation
aspect_ratio (optional): Image aspect ratio (default: "1:1")
output_format (optional): Output format - "webp", "jpg", or "png" (default: "webp")
num_outputs (optional): Number of images to generate (1-4, default: 1)

Example Usage

1const result = await use_mcp_tool({
2  server_name: "image-gen",
3  tool_name: "generate_image",
4  arguments: {
5    prompt: "A beautiful sunset over mountains",
6    aspect_ratio: "16:9",
7    output_format: "png",
8    num_outputs: 1
9  }
10});

The tool returns an array of URLs to the generated images.

📜 License

This project is licensed under the MIT License.

Contents