Image Generation MCP Server

👁 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

Related MCP server: FLUX MCP 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

👁 image

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.

👁 image

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

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• generate_imageC