Image Generation MCP Server

🚀 Image Generation MCP Server

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

🚀 Quick Start

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

📦 Installation

Install via Smithery

To automatically install the Image Generation MCP Server for Claude Desktop, install it via Smithery:

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

Option 1: NPX Method (No Local Setup)

You can use the package directly from npm without local installation:

# No installation required - npx will handle it

Option 2: Local Installation

If you prefer local installation:

# Install globally
npm install -g @gongrzhe/image-gen-server

# Or install locally
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 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 have 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": []
    }
  }
}

🌐 Environment Variables

• REPLICATE_API_TOKEN: Token for accessing the Replicate API.
• MODEL: Optional custom model name.

🎫 Get an API Token

1. Visit Replicate and register an account.
2. Find the API token in your profile.

💻 Usage Examples

Image Generation Tool

Features

• Generate high-quality images
• Support multiple styles and models

Basic Usage

await craft.image.generate({
  model: "stability-ai/sdxl", // Model name
  prompt: "A flying unicorn standing on a rainbow mountain", // Image description
  negative_prompt: "", // Optional, excluded content
  width: 1024, // Image width
  height: 1024, // Image height
  samples: 1, // Number of images to generate
  num_inference_steps: 20, // Number of inference steps
});

Example

The tool returns an array of URLs to the generated images.

📄 License

This project is licensed under the MIT License.