What is Image Generation Mcp Server

Image-Generation-MCP-Server is a server that provides image generation capabilities using the Replicate Flux model, allowing users to create images based on text prompts.

Use cases

Use cases for this server include creating artwork, generating images for marketing materials, designing visuals for social media, and producing illustrations for blogs or articles.

How to use

To use the Image-Generation-MCP-Server, set up the configuration file with your Replicate API token and desired model. Then, utilize the ‘generate_image’ tool by providing a text prompt and optional parameters to generate images.

Key features

Key features include the ability to generate images from text prompts, customizable output formats (webp, jpg, png), adjustable aspect ratios, and the option to specify the number of images to generate.

Where to use

undefined

Image Generation MCP Server

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

Installation

Installing via Smithery

To install Image Generation MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude

Option 1: NPX Method (No Local Setup Required)

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

# No installation needed - npx will handle it

Option 2: Local Installation

If you prefer a local installation:

# Global installation
npm install -g @gongrzhe/image-gen-server

# Or local installation
npm 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:

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "@gongrzhe/image-gen-server"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Option 2: Local Installation Configuration

If you installed the package locally:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": [
        "/path/to/image-gen-server/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Get Your Replicate API Token

1. Sign up/login at https://replicate.com
2. Go to https://replicate.com/account/api-tokens
3. Create a new API token
4. 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.

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

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

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

📜 License

This project is licensed under the MIT License.