Image Generation (Flux)

🚀 Image Generation MCP Server

This MCP server uses the Replicate Flux model to provide image generation capabilities.

🚀 Quick Start

This MCP server leverages the Replicate Flux model to offer image generation functionality.

📦 Installation

Install via Smithery

Automatically install the Image Generation MCP Server for Claude Desktop through Smithery:

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

Method 1: NPX (No Local Setup Required)

Use the package directly from npm without local installation:

# No installation needed, npx handles it

Method 2: Local Installation

If you need to install it locally:

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

Method 1: NPX Configuration (Recommended)

This method runs the server directly from npm without 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": []
    }
  }
}

Method 2: Local Installation Configuration

If you installed it 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/Log in 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 configuration

Environment Variables

• REPLICATE_API_TOKEN (Required): Replicate API token for authentication
• MODEL (Optional): Specify the model to use, default is "stable-diffusion"

💻 Usage Examples

generate_image

Generate images and return a list of URLs.

Parameters

{
  "prompt": "Enter your prompt, e.g., 'A flying blue bird'",
  "negative_prompt": "Optional, enter negative prompt",
  "width": 512,
  "height": 512,
  "samples": 1,
  "num_images": 1
}

Example Code

const response = await fetch('http://localhost:4000/api/generate-image', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: "A flying blue bird",
    negative_prompt: "",
    width: 512,
    height: 512,
    samples: 1,
    num_images: 1
  })
});

const data = await response.json();
console.log(data.urls); // Output the list of URLs

📄 License

This project is licensed under the MIT License.