What is Ai Image Gen Mcp

ai-image-gen-mcp is an MCP server implementation designed for generating images using the Replicate’s black-forest-labs/flux-schnell model. It allows users to create images from text prompts and is compliant with the MCP protocol.

Use cases

Use cases for ai-image-gen-mcp include generating illustrations for articles, creating unique artwork for social media posts, designing game assets based on narrative prompts, and producing visual content for advertising campaigns.

How to use

To use ai-image-gen-mcp, clone the repository, install dependencies using npm, and add your Replicate API token in the code. Then build the project and configure it within the Cursor settings as a new MCP server.

Key features

Key features include generating images from text prompts, configurable image parameters (resolution, aspect ratio, quality), saving generated images to a specified directory, full MCP protocol compliance, and robust error handling.

Where to use

ai-image-gen-mcp can be used in various fields such as digital art creation, content generation for marketing, game design, and any application requiring automated image generation from textual descriptions.

Image Generation MCP Server

An MCP (Model Context Protocol) server implementation for generating images using Replicate’s black-forest-labs/flux-schnell model.

Ideally to be used with Cursor’s MCP feature, but can be used with any MCP client.

Features

• Generate images from text prompts
• Configurable image parameters (resolution, aspect ratio, quality)
• Save generated images to specified directory
• Full MCP protocol compliance
• Error handling and validation

Prerequisites

• Node.js 16+
• Replicate API token
• TypeScript SDK for MCP

Setup

1. Clone the repository

2. Install dependencies:

   npm install
   

3. Add your Replicate API token directly in the code at src/imageService.ts by updating the apiToken constant:

   // No environment variables are used since they can't be easily set in cursor
   const apiToken = "your-replicate-api-token-here";
   

   Note: If using with Claude, you can create a .env file in the root directory and set your API token there:

   REPLICATE_API_TOKEN=your-replicate-api-token-here
   

   Then build the project:

   npm run build
   

Usage

To use with cursor:

1. Go to Settings
2. Select Features
3. Scroll down to “MCP Servers”
4. Click “Add new MCP Server”
5. Set Type to “Command”
6. Set Command to: node ./path/to/dist/server.js

API Parameters

Example Request

Example Response

{
  "image_paths": [
    "/var/output/images/output_0.webp",
    "/var/output/images/output_1.webp"
  ],
  "metadata": {
    "model": "black-forest-labs/flux-schnell",
    "inference_time_ms": 2847
  }
}

Error Handling

The server handles the following error types:

• Validation errors (invalid parameters)
• API errors (Replicate API issues)
• Server errors (filesystem, permissions)
• Unknown errors (unexpected issues)

Each error response includes:

• Error code
• Human-readable message
• Detailed error information

License

ISC