Google Image Search MCP

🚀 Google Image Search MCP Server

This MCP (Model Context Protocol) server provides Google Image Search functionality via SerpAPI. It allows AI assistants to perform image searches using Google Image Search and analyze the results according to specific criteria to find the most relevant images.

🚀 Quick Start

Prerequisites

• Ensure you have Node.js and npm installed on your system.
• Obtain a SerpAPI key from serpapi.com.

Installation

npm install

Configuration

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

SERP_API_KEY=your_serp_api_key_here

Build

npm run build

Run

npm start

Development

npm run dev

✨ Features

• Use Google Image Search to find images.
• Download images to a local directory.
• Analyze search results to determine their relevance criteria.

📦 Installation

npm install

💻 Usage Examples

Basic Usage

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your SERP_API_KEY

# Build the project
npm run build

# Start the server
npm start

Advanced Usage

# Run in development mode
npm run dev

📚 Documentation

Available Tools

search_images

Use Google Image Search to find images.

Parameters:

• query (string): The search term used to find images.
• limit (number, optional): The maximum number of results to return (default: 10).

download_image

Download an image to a local directory.

Parameters:

• imageUrl (string): The URL of the image to download.
• outputPath (string): The path to the target folder where the image will be saved.
• filename (string): The file name (including the extension) of the downloaded image.

analyze_images

Analyze image search results to find the most relevant images.

Parameters:

• searchResults (array): An array of image search results to analyze.
• criteria (string): The criteria used to select the best images (e.g., 'professional', 'colorful', etc.).

📄 License

ISC