mcpField
G
Gemini Image Generation MCP Server

Gemini Image Generation MCP Server

Local
github.com/sanxfxteamAI & Agents5Updated 83w ago
Repository

About Gemini Image Generation MCP Server

Gemini Image Generation MCP Server exposes Gemini 2's experimental image generation API to clients such as Claude Desktop. It generates images from prompts with options for sample count, aspect ratio, and person generation.

Key features

  1. 01Generate images from prompts
  2. 02Set the number of samples
  3. 03Choose an aspect ratio
  4. 04Configure person generation

Use cases

  1. 01Generating images from text descriptions
  2. 02Creating images in a specified aspect ratio

MCP support

The server communicates over MCP using stdio and exposes a generateImage tool that calls Gemini 2's experimental image generation API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gemini-mcp-server-sanxfxteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.