mikeyny/ai-image-gen-mcp

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:
bash
npm install
3. Add your Replicate API token directly in the code at src/imageService.ts by updating the apiToken constant:
bash
// 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:
bash
REPLICATEAPITOKEN=your-replicate-api-token-here
Then build the project:
bash
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
| Parameter | Type | Required | Default | Description |
| prompt | string | Yes | - | Text prompt for image generation |
| outputdir | string | Yes | - | Server directory path to save generated images |
| gofast | boolean | No | false | Enable faster generation mode |
| megapixels | string | No | "1" | Resolution quality ("1", "2", "4") |
| numoutputs | number | No | 1 | Number of images to generate (1-4) |
| aspectratio | string | No | "1:1" | Aspect ratio ("1:1", "4:3", "16:9") |
| outputformat | string | No | "webp" | Image format ("webp", "png", "jpeg") |
| outputquality | number | No | 80 | Compression quality (1-100) |
| numinferencesteps| number| No | 4 | Number of denoising steps (4-20) |
## Example Request
json
"prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'",
"outputdir": "/var/output/images",
"filename": "blackforestcake",
"outputformat": "webp"
"gofast": true,
"megapixels": "1",
"numoutputs": 2,
"aspectratio": "1:1"
## Example Response
json
"imagepaths": [