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.

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