npm package: @gongrzhe/image-gen-mcp-server
Description: An MCP server for image generation using Replicate Flux model
Author: Gong Rzhe
Latest version: 1.0.4

# Image Generation MCP Server

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

## Installation

```bash
npm install @gongrzhe/image-gen-mcp-server
```

## Setup

There are two ways to configure the server:

### Option 1: Using local build

1. Add the server configuration to your MCP settings file (located at `c:\Users\Administrator\AppData\Roaming\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`):

```json
{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["C:/Users/Administrator/Documents/Cline/MCP/image-gen-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### Option 2: Using npx (Recommended)

Add the server configuration to your MCP settings file:
```json
{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "@gongrzhe/image-gen-mcp-server@1.0.4"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### Option 3: Using npm global package

1. Install the package globally:
```bash
npm install -g @gongrzhe/image-gen-mcp-server
```

2. Add the server configuration to your MCP settings file:
```json
{
  "mcpServers": {
    "image-gen": {
      "command": "image-gen-mcp-server",
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

3. 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.

#### 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

```typescript
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.