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 "Install 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 Related Servers Score Discussions

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 installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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.
Last updated 2026-02-20
1
4
2
MIT
OpenRouter Image MCP Server
Image & Video Processing App Automation Multimedia Processing
WeiYu021
-
license
A
quality
-
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.
Last updated 2025-10-10
6
98
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.
Last updated 2025-09-07
2
1
Do What The F*ck You Want To Public
OpenRouter MCP Multimodal
AI & Machine Learning Image & Video Processing
Amama-Fatima
A
license
-
quality
D
maintenance
Enables chat and image analysis through OpenRouter.ai models. Supports text chat, image generation, and analysis with multiple images and custom questions.
Last updated 2026-03-04
245
Apache 2.0

View all related MCP servers

Related MCP Connectors

avots
Image, video, audio, face-swap, talking avatars and chat across 300+ AI models, one balance.
designforyou
Generate logos, social posts, app screenshots, comic panels & visual-novel assets from prompts.
Glif
Generate images, video, and audio with Glif's media-generation agent

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nguyen1oc/mcp-librechat-image-generation-via-OP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server