English Français العربية

ai.smithery/Artin0123-gemini-image-mcp-server

Official registry Media and design

Analyze images and videos with Gemini to get fast, reliable visual insights. Handle content from U…

Source code Documentation

What can you do with ai.smithery/Artin0123-gemini-image-mcp-server?

  • Analyze one or more image URLs with a single tool call.
  • Analyze YouTube videos without downloading files locally.
  • Supply an API key and optionally override the Gemini model via environment variables.
  • File size limit: Images are limited to 16 MB to ensure fast processing.
  • YouTube videos: No size limit as they are streamed directly by Gemini API.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http artin0123-gemini-image-mcp-server 'https://server.smithery.ai/@Artin0123/gemini-image-mcp-server/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "artin0123-gemini-image-mcp-server": {
            "type": "http",
            "url": "https://server.smithery.ai/@Artin0123/gemini-image-mcp-server/mcp",
            "headers": {
                "Authorization": "<Bearer token for Smithery authentication>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. image-mcp-server-gemini
  2. Features
  3. Installation
  4. Configuration
  5. Available tools
  6. Development
  7. License

image-mcp-server-gemini

This is remote server, use local version for local images and videos.

Features

  • Analyze one or more image URLs with a single tool call.
  • Analyze YouTube videos without downloading files locally.
  • Supply an API key and optionally override the Gemini model via environment variables.
  • File size limit: Images are limited to 16 MB to ensure fast processing.
  • YouTube videos: No size limit as they are streamed directly by Gemini API.

Installation

Installing via Smithery

Install the server in Claude Desktop:

npx -y @smithery/cli install @Artin0123/gemini-image-mcp-server --client claude
Manual Installation
# Clone the repository
git clone https://github.com/Artin0123/gemini-vision-mcp.git
cd gemini-vision-mcp

# Install dependencies
npm install

# Compile TypeScript to dist/
npm run build

Configuration

Create a Gemini API key in Google AI Studio and provide GEMINI_API_KEY to the server.

{
  "mcpServers": {
    "gemini-media": {
      "command": "node",
      "args": ["/absolute/path/to/gemini-vision-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "models/gemini-flash-lite-latest"
      }
    }
  }
}

If no key is supplied, the server can still start (handy for automated scans), but any tool invocation will return a configuration error until a valid API key is configured.

Model override

The server defaults to models/gemini-flash-lite-latest. Override it by either:

Setting the GEMINI_MODEL environment variable, or Providing modelName in the Smithery/SDK configuration schema.

Available tools

  • analyze_image: Analyze one or more image URLs. Maximum file size: 16 MB per image.
  • analyze_youtube_video: Analyze a YouTube video from URL. No size limit.

Image URLs are downloaded and processed with a 16 MB size limit to ensure fast response times. Files exceeding this limit will result in an error message indicating the actual file size.

YouTube videos are streamed directly by Gemini API without downloading, so there is no size restriction.

Prompt examples
Please analyze this product photo: https://teimg-bgr.pages.dev/file/mvYT6KeF.webp
Extract the main talking points from this clip: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Development

npm install
npm test
npm run build

The test suite exercises URL forwarding, MIME handling, and configuration fallbacks.

License

MIT

Frequently asked questions

What is ai.smithery/Artin0123-gemini-image-mcp-server?

Analyze images and videos with Gemini to get fast, reliable visual insights. Handle content from U…

How do I install ai.smithery/Artin0123-gemini-image-mcp-server?

It runs as a remote server. In Claude Code: claude mcp add --transport http artin0123-gemini-image-mcp-server 'https://server.smithery.ai/@Artin0123/gemini-image-mcp-server/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ai.smithery/Artin0123-gemini-image-mcp-server need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is ai.smithery/Artin0123-gemini-image-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ai.smithery/Artin0123-gemini-image-mcp-server?

It is published by Artin0123. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.