Image Generation

What is Image-Generation-MCP-Server?

Image-Generation-MCP-Server is an MCP (Multi-Client Protocol) server that provides image generation capabilities. It leverages the Replicate Flux model to generate images from text prompts.

How to use Image-Generation-MCP-Server?

Image-Generation-MCP-Server can be installed and used in several ways:

Installation

• Via Smithery: Automatically install for Claude Desktop using npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude.
• NPX Method: Use directly from npm without local installation.
• Local Installation: Install globally with npm install -g @gongrzhe/image-gen-server or locally with npm install @gongrzhe/image-gen-server.

Setup

1. Configure Claude Desktop: Edit your claude_desktop_config.json file (location varies by OS).
2. Add MCP Server Configuration: Add a new entry under mcpServers for "image-gen", specifying the command (npx or node), arguments, and environment variables.
3. Get Replicate API Token: Obtain an API token from Replicate and replace your-replicate-api-token in the configuration.

Environment Variables

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

Configuration Parameters

• disabled: Set to true to disable the server.
• autoApprove: An array of tool names that can be executed without user confirmation.

Available Tools

• generate_image: Generates images using the Flux model based on text prompts.
  • Parameters:
    • prompt (required): Text description of the image.
    • seed (optional): Random seed for reproducibility.
    • 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.

Key Features of Image-Generation-MCP-Server

• Image Generation: Creates images from textual descriptions.
• Replicate Flux Model Integration: Utilizes a powerful AI model for high-quality image generation.
• Flexible Installation: Supports installation via Smithery, NPX, or local npm.
• Configurable: Allows customization of API tokens, models, and server behavior.
• Tool-based Interface: Provides a generate_image tool with various parameters for fine-grained control.
• Multiple Output Formats: Supports WEBP, JPG, and PNG output.
• Reproducible Generation: Offers a seed parameter for consistent results.

Use Cases of Image-Generation-MCP-Server

• Content Creation: Generate unique images for blogs, social media, and marketing materials.
• Prototyping and Design: Quickly create visual concepts and mockups.
• Creative Exploration: Experiment with different prompts and styles to generate artistic images.
• Automated Image Generation: Integrate into workflows for automated image creation based on data or events.
• Educational Purposes: Explore the capabilities of AI-powered image generation.

FAQ from Image-Generation-MCP-Server

• What is REPLICATE_API_TOKEN? It is your authentication token for the Replicate API, required to use their models. You can obtain it from your Replicate account settings.

• Can I use a different model than the default? Yes, you can specify an alternative Replicate model using the MODEL environment variable in your Claude Desktop configuration.

• How many images can I generate at once? You can generate between 1 and 4 images per request using the num_outputs parameter.

• What image formats are supported? The generate_image tool supports WEBP, JPG, and PNG output formats.

• How can I ensure the same image is generated every time? You can use the seed parameter with a specific value to achieve reproducible image generation.

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.