Skip to main content
Glama
Sign In
enesjakozh

Image Generation MCP Server

by mikeyny
GitHub
TypeScript
63
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Integrates with Replicate's 'black-forest-labs/flux-schnell' model to generate images from text prompts

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

ParameterTypeRequiredDefaultDescription
promptstringYes-Text prompt for image generation
output_dirstringYes-Server directory path to save generated images
go_fastbooleanNofalseEnable faster generation mode
megapixelsstringNo"1"Resolution quality ("1", "2", "4")
num_outputsnumberNo1Number of images to generate (1-4)
aspect_ratiostringNo"1:1"Aspect ratio ("1:1", "4:3", "16:9")
output_formatstringNo"webp"Image format ("webp", "png", "jpeg")
output_qualitynumberNo80Compression quality (1-100)
num_inference_stepsnumberNo4Number of denoising steps (4-20)

Example Request

{ "prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'", "output_dir": "/var/output/images", "filename": "black_forest_cake", "output_format": "webp" "go_fast": true, "megapixels": "1", "num_outputs": 2, "aspect_ratio": "1:1" }

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Enables users to generate images from text prompts using Replicate's model, with configurable parameters and full MCP protocol compliance.

  1. Features
    1. Prerequisites
      1. Setup
        1. Usage
          1. API Parameters
            1. Example Request
              1. Example Response
                1. Error Handling
                  1. License

                    Related Resources

                    Related MCP Servers

                    • Together AI Image Server

                      zym9863
                      A
                      security
                      A
                      license
                      A
                      quality
                      A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.
                      Last updated -
                      1
                      2
                      TypeScript
                      MIT License
                      • Apple
                      • Linux

                    • Flux Image MCP Server

                      ckz
                      -
                      security
                      A
                      license
                      -
                      quality
                      Provides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.
                      Last updated -
                      1
                      JavaScript
                      MIT License

                    • Image-Gen-Server

                      fengin
                      -
                      security
                      A
                      license
                      -
                      quality
                      A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.
                      Last updated -
                      82
                      Python
                      MIT License
                      • Apple
                      • Linux

                    • Image Generator MCP Server

                      luoshui-coder
                      -
                      security
                      -
                      license
                      -
                      quality
                      A TypeScript-based MCP server that lets users generate images using OpenAI's dall-e-3 model by providing a prompt and image name.
                      Last updated -
                      1

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    ID: 5dft5chv70