home / mcp / image generation mcp server

Image Generation MCP Server

Provides an MCP server to generate blog and social images via Google's Gemini with a configurable provider interface.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "12-days-of-shipmas-2025-day-1-image-generation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "image-generation-mcp"
      ],
      "env": {
        "Other": "<Other>",
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

You can generate high-quality blog and social media images automatically by running an MCP server that talks to Google Gemini through a simple provider interface. This server handles input validation, prompt sanitization, and outputs images in standard presets, making it easy to create eye-catching visuals for posts, articles, and feeds.

How to use

To use the image generation MCP server, connect a client that supports MCPs and point it at your configured image_gen MCP server. You supply a prompt and optional metadata like the target platform format, desired quality, and a contextual title. The server returns a generated image or saves it to disk per your settings. Use the built‑in tools to generate blog banners or social media images across presets such as Ghost, Medium, Instagram, or Twitter.

How to install

Prerequisites: you need Node.js and npm installed on your system. Make sure you have an active Google API key for Gemini.

Install the MCP image generation server approach by using the supported setup paths described here. The server can be added to your Claude Code or Claude Desktop workflow as a local (stdio) MCP server.

Configuration and usage notes

The following runtime configurations are shown for running the MCP server locally. You will set your Google API key in the environment when you start the server. The supported setup options include using npx to run the MCP, or running a local node process that points to the built distribution.

Security and best practices

Limit access to your MCP server to trusted clients. Keep your Google API key secure, avoid exposing it in version control, and rotate it if you suspect it has been compromised. Validate prompts and output paths on the client side as an added safety measure.

Troubleshooting

If the MCP server does not respond, verify that the Google API key is correctly set in your environment and that the server process has started with the expected command. Check that the client is correctly configured to point to the MCP server and that the required environment variables are visible to the process.

Available tools

generate_blog_image

Generate an image for blog posts or social media using a textual prompt plus optional parameters like format, quality, and style.

list_image_formats

List all available image format presets to choose the desired output dimensions.