Image Gemini MCP Server

MCP server for image analysis using GPT-4o-mini

Local serverstdioTypeScript

What is the Image Gemini MCP server?

Connect Image Gemini to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server for image analysis using GPT-4o-mini. The image gemini mcp server is what makes that connection.

What the server does

An MCP server that receives image/video URLs or local file paths and analyzes their content using the Gemini 2.0 Flash model.(forked from github.com/champierre/image-mcp-server)

  • Analyzes content from one or more image/video URLs or local file paths
  • Analyzes videos directly from YouTube URLs
  • Can analyze relationships between multiple images or videos provided together
  • Supports optional text prompts to guide the analysis
  • High-precision recognition and description using the Gemini 2.0 Flash model
  • URL validity checking and local file loading with Base64 encoding

Installation

@smithery/cli on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • analyze_image — Receives one or more image URLs and analyzes their content
  • Arguments — imageUrls (array of strings, required), prompt (string, optional)
  • analyze_image_from_path — Receives one or more local image file paths and analyzes their content
  • analyze_video — Receives one or more video URLs and analyzes their content. Best for smaller videos (see Video Notes)
  • analyze_video_from_path — Receives one or more local video file paths and analyzes their content. Best for smaller videos (see Video Notes)
  • analyze_youtube_video — Receives a single YouTube video URL and analyzes its content

Credentials and setup notes

Configuration is passed through the environment: GEMINI_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Image Gemini's toolset — analyze_image, Arguments, analyze_image_from_path and 3 more — is a fair guide to whether it matches your workflow. It is maintained by rentapad; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
analyze_imageReceives one or more image URLs and analyzes their content.
ArgumentsimageUrls (array of strings, required), prompt (string, optional).
analyze_image_from_pathReceives one or more local image file paths and analyzes their content.
analyze_videoReceives one or more video URLs and analyzes their content. Best for smaller videos (see Video Notes).
analyze_video_from_pathReceives one or more local video file paths and analyzes their content. Best for smaller videos (see Video Notes).
analyze_youtube_videoReceives a single YouTube video URL and analyzes its content.

How to install the Image Gemini MCP server

{
  "mcpServers": {
    "image-mcp-server-gemini": {
      "command": "npx",
      "args": ["-y", "@smithery/cli"],
      "env": {
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
GEMINI_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Image Gemini to analyze image.
  • Use Image Gemini to Arguments.
  • Use Image Gemini to analyze image from path.

Frequently asked questions

It connects Image Gemini to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (analyze_image, Arguments, analyze_image_from_path, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Image Gemini directly.