image-mcp

An MCP server that provides image generation tools powered by OpenRouter. Runs on Cloudflare Workers.

Tools

generate_image

Generate an image from a text prompt.

Related MCP server: OpenRouter MCP Multimodal Server

Setup

1. Get an OpenRouter API key

Create an API key at OpenRouter.

2. Configure your MCP client

Add the server to your MCP configuration file (e.g. ~/.claude/mcp.json for Claude Code, claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "image-mcp": {
      "type": "url",
      "url": "https://image.mcp.nqs.io?apiKey=YOUR_OPENROUTER_API_KEY"
    }
  }
}

Replace YOUR_OPENROUTER_API_KEY with your actual OpenRouter API key.

Self-hosting

If you'd prefer to deploy your own instance instead of using the hosted version:

Prerequisites

• Node.js >= 20

• A Cloudflare account

• An OpenRouter API key

Deploy

1. Clone the repo and install dependencies:

   git clone https://github.com/nqs/images-mcp.git
   cd images-mcp
   npm install

2. Set your OpenRouter API key as a Wrangler secret:

   npx wrangler secret put OPENROUTER_API_KEY
   # Paste your OpenRouter API key when prompted

3. Update wrangler.toml with your own domain or remove the routes section to use the default *.workers.dev subdomain.

4. Deploy with Wrangler:

   npx wrangler deploy

   Or push to main to trigger the included GitHub Actions workflow (requires CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID secrets).

5. Point your MCP config at your deployed URL:

   {
     "mcpServers": {
       "image-mcp": {
         "type": "url",
         "url": "https://your-worker.your-subdomain.workers.dev?apiKey=YOUR_OPENROUTER_API_KEY"
       }
     }
   }

Local development

export OPENROUTER_API_KEY="your-openrouter-key-here"
npm run dev    # starts server with file watcher
npm test       # runs the test suite

Image Generation Model

This server uses black-forest-labs/flux.2-klein-4b via OpenRouter for image generation by default. You can specify a different model via the model parameter in the generate_image tool call.

License

MIT