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

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

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.