Skip to main content
Glama
google-image-search-mcp

google-image-search-mcp

by Virul360

Google Image Search MCP Server

This MCP (Model Context Protocol) server provides Google Image Search functionality through the SerpAPI. It allows AI assistants to search for images and analyze the results to find the most relevant ones based on specific criteria.

Features

  • Search for images with Google Image Search

  • Download images to a local directory

  • Analyze search results based on relevance criteria

Related MCP server: SerpApi MCP Server

Installation

npm install

Configuration

Create a .env file with your SerpAPI key (you can copy from .env.example):

SERP_API_KEY=your_serp_api_key_here

You can get a SerpAPI key by signing up at serpapi.com.

Usage

Building

npm run build

Running

npm start

Development

npm run dev

Available Tools

search_images

Search for images using Google Image Search.

Parameters:

  • query (string): The search query for finding images

  • limit (number, optional): Maximum number of results to return (default: 10)

download_image

Download an image to a local directory.

Parameters:

  • imageUrl (string): URL of the image to download

  • outputPath (string): Directory path where the image should be saved

  • filename (string): Filename for the downloaded image (including extension)

analyze_images

Analyze image search results to find the most relevant ones.

Parameters:

  • searchResults (array): Array of image search results to analyze

  • criteria (string): Criteria for selecting the best images (e.g., 'professional', 'colorful', etc.)

License

ISC

Available Tools

3 tools
analyze_imagesB

Analyze image search results to find the most relevant ones

Inputs: criteria (required), searchResults (required).

download_imageC

Download an image to a local directory

Inputs: filename (required), imageUrl (required), outputPath (required).

search_imagesC

Search for images using Google Image Search

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 3 tools

    Disambiguation4/5

    Each tool has a distinct role: search returns images, analyze evaluates relevance, download saves locally. The line between search and analyze could cause minor confusion, but descriptions clarify.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case: search_images, analyze_images, download_image.

    Tool Count4/5

    3 tools is slightly low for a search service, but for a focused utility it's reasonable and each tool serves a clear purpose.

    Completeness3/5

    Core search, analysis, and download are covered, but missing image metadata retrieval, pagination, or search refinement are notable gaps.

    Related MCP Connectors

    Related MCP Servers