sanxfxteam_gemini_mcp_server

sanxfxteam_gemini_mcp_server

by sanxfxteam
An MCP server that provides image generation capabilities using Google's Gemini 2 API.

Gemini Image Generation MCP Server

Gemini Image Generation Server MCP server

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

Quick Start

  1. Get Gemini API Key
  2. Visit Google AI Studio
  3. Create a new API key

  4. Configure Claude Desktop

  5. 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
  6. Add Gemini configuration:
    json { "mcpServers": { "gemini-imagen": { "command": "npx", "args": ["-y", "github:sanxfxteam/gemini-mcp-server"], "env": { "GEMINI_API_KEY": "your_api_key_here" } } } }

  7. Restart Claude Desktop

Setup

  1. Install dependencies:
    shell npm install

  2. 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

About

Generate images using Gemini

Resources

Readme

License

MIT license

Activity

Stars

1 star

Watchers

1 watching

Forks

1 fork

Report repository

Releases

No releases published

Packages 0

No packages published

Contributors 2

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol javascript image_generation api_integration google_gemini

Implementation Details

Stats

0 Views
1 GitHub Stars

Repository Info

sanxfxteam Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
21423
9300