Gongrzhe Image Generation MCP Server

🚀 Image Generation MCP Server

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

🚀 Quick Start

This MCP server provides the image generation functionality with the Replicate Flux model.

📦 Installation

Configuration Steps

1. Configuration File Location:

   • On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%/Claude/claude_desktop_config.json

   {
     "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": []
       }
     }
   }
   

2. Obtain Your Replicate API Token:

   • Sign up or log in at https://replicate.com.
   • Visit https://replicate.com/account/api-tokens.
   • Create a new API token.
   • Copy the token and replace your-replicate-api-token in the configuration file.

Environment Variables

• REPLICATE_API_TOKEN (Required): The Replicate API token for authentication.
• MODEL (Optional): The name of the Replicate model for image generation. Defaults to "black-forest-labs/flux-schnell".

Configuration Parameters

• disabled: Controls whether the server is enabled (false for enabled, true for disabled).
• autoApprove: An array of tool names that can be automatically executed without user confirmation. An empty array means all tool calls require confirmation.

💻 Usage Examples

Available Tools

generate_image

Generate an image based on a text prompt using the Flux model.

Parameters

• prompt (Required): A text prompt describing the image.
• seed (Optional): A random seed for reproducible results.
• aspect_ratio (Optional): The aspect ratio of the image, defaults to "1:1".
• output_format (Optional): The output format, supports "webp", "jpg", or "png", defaults to "webp".
• num_outputs (Optional): The number of images to generate (range 1 - 4, defaults to 1).

Basic Usage

const result = await use_mcp_tool({
  server_name: "image-gen",
  tool_name: "generate_image",
  arguments: {
    prompt: "夕阳下 mountains 的美景", // 美丽的落日 mountain 风光
    aspect_ratio: "16:9",
    output_format: "png",
    num_outputs: 1
  }
});

This tool returns an array of URLs for the generated images.

📄 License

This project is released under the MIT License.