Imagen3-MCP Server

You can run Imagen3-MCP to offer image generation services powered by Google's Imagen 3.0 via MCP. It lets clients request photorealistic images through a simple, standardized interface, with configuration options for hosting, networking, and API access.

How to use

You connect an MCP client to the Imagen3-MCP server and send image-generation requests using the MCP protocol. Your client can request artwork like photorealistic scenes or tech-inspired graphics, receiving generated images in response. Start with a local or remote server instance, then point your client at the server address and send requests describing the image prompt, any preferred styling, and desired output settings. Use the server as a drop-in image generator for workflows, apps, or automation that require dynamic image creation.

How to install

Prerequisites: you need a valid Google Gemini API key to access Imagen 3.0. You do not need to install a separate client library if you plan to run the server as described below.

Install using Cherry Studio (recommended path):

1. Download the latest executable from GitHub Releases.

2. Place the downloaded executable anywhere on your system, for example C:\bin\imagen3-mcp.exe.

3. In Cherry Studio, configure the MCP server with the following settings:

• Command: C:\bin\imagen3-mcp.exe

• Environment variable GEMINI_API_KEY: your Gemini API key

• Optional environment variable BASE_URL: proxy URL (for example https://lingxi-proxy.hamflx.dev/api/provider/google). This helps bypass certain network restrictions but does not bypass IP blocking.

• Optional environment variable SERVER_LISTEN_ADDR: IP address the server listens on (default 127.0.0.1).

• Optional environment variable SERVER_PORT: port for the server and image URLs (default 9981).

• Optional environment variable IMAGE_RESOURCE_SERVER_ADDR: address used in image URLs (default 127.0.0.1). Useful when the server runs in a container or on a remote machine.

Install via Cursor (MCP config example):

{
  "mcpServers": {
    "imagen3": {
      "command": "C:\\bin\\imagen3-mcp.exe",
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
        // Optional environment variables:
        // "BASE_URL": "<PROXY_URL>",
        // "SERVER_LISTEN_ADDR": "0.0.0.0",
        // "SERVER_PORT": "9981",
        // "IMAGE_RESOURCE_SERVER_ADDR": "your.domain.com"
      }
    }
  }
}

Additional installation notes

If you prefer a minimal setup, you can run the server locally and expose it as needed. Ensure your Gemini API key is kept secure and not embedded in client-side code. When deploying in containers or across machines, adjust SERVER_LISTEN_ADDR, SERVER_PORT, and IMAGE_RESOURCE_SERVER_ADDR to match your environment.

Available tools

imagen3_mcp

Image generation tool powered by Google's Imagen 3.0 accessible through MCP. Accepts prompts and returns generated images.