Gemini Image Generation MCP Server

Gemini Image Generation MCP Server

By sanxfxteam GitHub

Generate images using gemini

Overview

what is Gemini MCP Image Generation Server?

Gemini MCP Image Generation Server is a server that provides image generation capabilities using Google's Gemini 2 API, allowing users to create images based on textual descriptions.

how to use Gemini MCP Image Generation Server?

To use the server, install the necessary dependencies, set up your environment variables with your Google API key, and run the server using npm commands.

key features of Gemini MCP Image Generation Server?

  • Generates images using Gemini 2's experimental image generation API.
  • Customizable parameters for image generation including prompt, number of samples, and aspect ratio.
  • Supports Model Context Protocol for communication.

use cases of Gemini MCP Image Generation Server?

  1. Creating unique artwork based on user-defined prompts.
  2. Generating images for marketing materials or social media content.
  3. Assisting developers in testing image generation capabilities in applications.

FAQ from Gemini MCP Image Generation Server?

  • What is required to run the server?

You need to install Node.js and have a valid Google API key to access the Gemini 2 API.

  • Can I customize the images generated?

Yes! You can customize the prompt, number of images, and aspect ratio when making requests.

  • Is there a limit to the number of images I can generate?

The default number of samples is 4, but you can specify a different number in your request.

Content

Gemini Image Generation MCP Server

This is a Model Context Protocol (MCP) server that provides image generation capabilities using Google's Gemini 2 API.

Gemini Image Generation Server MCP server

Quick Start

  1. Get Gemini API Key

  2. Configure Claude Desktop

    • Locate your config file: 
      Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
    • Add Gemini configuration: 
      {
  "mcpServers": {
    "gemini-imagen": {
      "command": "npx",
      "args": ["-y", "github:sanxfxteam/gemini-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

  3. Restart Claude Desktop

Setup

  1. Install dependencies:
npm install
  1. Set up your environment variables: Create a .env file in the root directory and add your Google API key:
GEMINI_API_KEY=your_api_key_here

Usage

Run the server:

npm start

To test

npx @modelcontextprotocol/inspector npm run start

Available Tools

generateImage

Generates images using Gemini 2's experimental image generation API.

Parameters:

  • prompt (string, required): The description of the image you want to generate
  • numSamples (number, optional, default: 4): Number of images to generate
  • aspectRatio (string, optional, default: '1:1'): Aspect ratio of the generated images
  • personGeneration (string, optional, default: 'ALLOW_ADULT'): Person generation settings

Example MCP request:

{
  "tool": "generateImage",
  "params": {
    "prompt": "A serene mountain landscape at sunset",
    "numSamples": 2,
    "aspectRatio": "16:9"
  }
}

Notes

  • This server uses the experimental image generation feature of Gemini 2
  • Make sure you have appropriate access and API keys from Google
  • The server communicates using the Model Context Protocol over stdio
No tools information available.
No content found.