Which integrations are available for this server?

Allows retrieval of user-uploaded images stored in a MongoDB database used by LibreChat, and provides image generation capabilities via OpenRouter models.

How do I use OpenRouter Custom Image Generation MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OpenRouter Custom Image Generation MCP Server Edit my uploaded image of a car to make it red" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OpenRouter Custom Image Generation MCP Server

by nguyen1oc

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

🖼️ MCP Image Generation Server for LibreChat

A custom Model Context Protocol (MCP) server that provides AI image generation capabilities to LibreChat via OpenRouter.

Model: Locked to google/gemini-2.5-flash-image for all requests. To change the model, modify the source code in tools.js.

📂 Project Structure

mcp-image-gen-custom/
├── index.js          # Express app, SSE transport, MCP server + tool registration
├── tools.js          # Tool handlers: get_user_images, generate_image, rate limiting
├── openrouter.js     # OpenRouter API communication (chat completions with image modality)
├── files.js          # MongoDB file record lookup + local file stream reader
├── db.js             # MongoDB connection pool manager
├── Dockerfile        # Container build definition
├── package.json
└── example/
    ├── docker-compose.override.example.yml   # Docker service config example
    ├── librechat.example.yaml                # librechat.yaml MCP config example
    └── system_instructions.example.md        # Agent system prompt template

Related MCP server: OpenRouter Image MCP Server

🛠️ Tools Provided

1. `get_user_images`

Retrieves images uploaded by the current user in LibreChat, returning index aliases and file_ids for use as reference images.

Argument	Type	Required	Description
`limit`	number	No	Max images to return. Default: `10`

Example response:

Found 2 uploaded image(s):
1. [INDEX_1] file_id: "cab88c4e-aecb-4812-9fff-6c85aede6362" — mycar.png
2. [INDEX_2] file_id: "f6752381-3a6d-4b69-a92b-5555a9521069" — cat.png

Use EITHER the file_id OR the index number (e.g., '1', '2' or 'INDEX_1', 'INDEX_2') as the reference_image_url when calling generate_image.

2. `generate_image`

Generates an image from a text prompt. Supports Text-to-Image and Image-to-Image (editing) via reference images.

Argument	Type	Required	Description
`prompt`	string	✅	Text description of the image to generate
`reference_image_url`	string	No	Index alias (`"1"`, `"INDEX_1"`) or local `file_id` of a single reference image
`reference_image_urls`	string[]	No	List of index aliases or `file_id`s for multiple reference images
`aspect_ratio`	string	No	Output image dimensions. See options below

Aspect ratio options:

Value	Shape	Common use
`1:1`	Square	Profile pictures, feed posts
`16:9`	Wide landscape	Banners, cover photos
`9:16`	Tall portrait	Stories, Reels, TikTok
`4:5`	Portrait	Feed posts (portrait)

Note: aspect_ratio only controls image dimensions — it does not affect image style or content.

Note: Do NOT pass Google/OpenAI temporary file-xxxx IDs into reference_image_url. These are not stored in the local database. Always use get_user_images first to get valid index aliases or local file_ids.

🔒 Per-User Rate Limiting

The server enforces configurable usage limits per user to prevent spam. Limits are tracked in MongoDB (mcp_image_gen_usage collection).

Env Variable	Default	Description
`IMAGE_GEN_DAILY_LIMIT`	`3`	Max images per user per day (reset at midnight local time)
`IMAGE_GEN_COOLDOWN_SEC`	`30`	Min seconds between generations per user

To reset limits manually (all users):

docker exec chat-mongodb mongosh LibreChat --eval "db.mcp_image_gen_usage.deleteMany({})"

To reset limits for a specific user:

docker exec chat-mongodb mongosh LibreChat --eval "db.mcp_image_gen_usage.deleteMany({ userId: ObjectId('<userId>') })"

To view current usage:

docker exec chat-mongodb mongosh LibreChat --eval "db.mcp_image_gen_usage.aggregate([{ \$group: { _id: '\$userId', count: { \$sum: 1 } } }]).forEach(r => print(r._id, '->', r.count))"

⚙️ How Index Resolution Works

The LLM agent only sees image bytes in chat history — it does not know the database file_id. This server resolves short index aliases (e.g., "1" or "INDEX_1") to the correct local file_id automatically.

sequenceDiagram
    actor User
    participant Agent as LLM Agent
    participant MCP as MCP Server
    participant DB as MongoDB

    User->>Agent: "Edit this image" (uploads car.png)
    Agent->>MCP: get_user_images()
    MCP->>DB: Query user's latest images
    DB-->>MCP: [car.png → file_id: "abc-123"]
    MCP-->>Agent: "1. [INDEX_1] file_id: 'abc-123' — car.png"
    Agent->>MCP: generate_image(prompt="make it red", reference_image_url="INDEX_1")
    Note over MCP: Resolves "INDEX_1" → "abc-123"
    MCP->>DB: Fetch file "abc-123" from disk
    MCP-->>User: Returns edited image ✅

🚀 Installation & Deployment

Prerequisites

LibreChat running via Docker Compose
An OpenRouter API key

Step 1: Place this folder

Clone or copy this mcp-image-gen-custom/ directory into the root of your LibreChat repository:

LibreChat/
├── mcp-image-gen-custom/   ← here
├── api/
├── docker-compose.yml
└── ...

Step 2: Configure Environment Variables

Add the following to your .env file at the LibreChat root:

# Required
OPENROUTER_KEY=your_openrouter_api_key_here

# Optional — image generation rate limits
IMAGE_GEN_DAILY_LIMIT=3
IMAGE_GEN_COOLDOWN_SEC=30

Step 3: Add the MCP service to Docker Compose

Add the following to your docker-compose.override.yml (create it if it doesn't exist):

services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

  mcp-image-gen:
    build: ./mcp-image-gen-custom
    restart: always
    environment:
      NODE_ENV: ${NODE_ENV:-production}
      PORT: 3013
      OPENROUTER_KEY: ${OPENROUTER_KEY}
      OPENROUTER_API_KEY: ${OPENROUTER_KEY}
      MONGO_URI: mongodb://mongodb:27017/LibreChat
      IMAGE_GEN_DAILY_LIMIT: ${IMAGE_GEN_DAILY_LIMIT:-3}
      IMAGE_GEN_COOLDOWN_SEC: ${IMAGE_GEN_COOLDOWN_SEC:-30}
    volumes:
      - ./uploads:/app/uploads   # shared with LibreChat api container
      - ./images:/app/images     # shared with LibreChat api container
    expose:
      - "3013"
    networks:
      - default

See example/docker-compose.override.example.yml for a complete example.

Step 4: Register the MCP server in `librechat.yaml`

Append the following to your librechat.yaml:

mcpSettings:
  allowedDomains:
    - 'mcp-image-gen'
  allowedAddresses:
    - 'mcp-image-gen:3013'

mcpServers:
  openrouter-imager:
    type: sse
    url: http://mcp-image-gen:3013/sse
    headers:
      x-user-id: '{{LIBRECHAT_USER_ID}}'

See example/librechat.example.yaml for a complete example.

Step 5: Build and start

# Build and start all services
docker compose up -d --build

# Restart the LibreChat API to reload librechat.yaml
docker compose restart api

Step 6: Configure the Agent in LibreChat UI

Go to LibreChat → Agents and create a new agent (or edit an existing one).
Enable the openrouter-imager MCP tool.
Paste the system prompt from example/system_instructions.example.md into the Instructions field.

🔧 Changing the Model

The model is hardcoded to google/gemini-2.5-flash-image in tools.js:

const selectedModel = "google/gemini-2.5-flash-image";

To use a different model, edit this line directly and rebuild the container:

docker compose up -d --build mcp-image-gen

📋 Useful Commands

# View live MCP server logs
docker logs librechat-mcp-image-gen-1 -f

# Rebuild and restart MCP server only
docker compose up -d --build mcp-image-gen

# Reset all image generation usage limits
docker exec chat-mongodb mongosh LibreChat --eval "db.mcp_image_gen_usage.deleteMany({})"

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

APICK AI A
app.apick
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
AI & Machine Learning Image & Video Processing
1511
Codex Imagem A
io.github.mcp-dir
Generate images with your own ChatGPT subscription (Plus, Pro or Team), without spending API credits
AI & Machine Learning Image & Video Processing
81
fengyinxia-jimeng-mcp
ai.smithery
Create images and videos from prompts, with options for image mixing, reference images, and start/…
Image & Video Processing Multimedia Processing
2
AI Media StudioOAuth
ai.b77
Generate images, videos, voiceovers, and captions from a chat prompt.
AI & Machine Learning Image & Video Processing Audio Processing
1

Related MCP Servers

Azure Image Generation MCP
Image & Video Processing Multimedia Processing Developer Tools
malikmalikayesha
A
license
B
quality
D
maintenance
Enables AI-powered image generation using Azure DALL-E 3 and FLUX models with intelligent automatic model selection. Generates stunning photorealistic or creative images directly within LibreChat through simple text prompts.
Updated 7 months ago (2026-02-20 16:18 UTC)
1
20 npm
2
MIT
OpenRouter Image MCP Server
Image & Video Processing App Automation Multimedia Processing
WeiYu021
-
license
A
quality
Not graded
maintenance
Enables generating and editing images using OpenRouter's API with Gemini 2.5 Flash Image model. Supports custom aspect ratios, iterative editing, and reference images for style transfer.
Updated a year ago (2025-10-10 15:46 UTC)
6
23 npm
-
OpenRouter Image Generation
hz1ulqu01gmnZH4
A
license
B
quality
D
maintenance
Enables image generation via OpenRouter API, supporting models like Gemini 2.5 Flash Image Preview with options to save files locally.
Updated a year ago (2025-09-07 15:51 UTC)
2
1
Do What The F*ck You Want To Public
openrouter-image-gen-mcp
Image & Video Processing AI & Machine Learning
jtxmp
A
license
Not graded
quality
D
maintenance
Enables AI assistants to generate and edit images using multiple models through OpenRouter, with features like style presets, batch operations, and variations.
Updated 6 months ago (2026-03-07 11:23 UTC)
22 npm
1
MIT