Labsco
srigi logo

Google Images Search

★ 12

from srigi

Search for Google images, view results, and download them directly within your IDE.

🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#database#cloud#git#security

🖼️ Google Images Search MCP

logo

Search. See. Save. – The only MCP that shows Google Images results directly in your chat as actual images, not just links!

Unlike other tools that return text descriptions or links, this MCP displays search results as actual images in your conversation. Works with Cline and Windsurf.

Perfect for getting visual inspiration, finding assets for projects, or quickly browsing images without leaving your IDE.

Demo

Demo

🚀 Development

Want to contribute? Great! Quality contributions are welcomed.

Requirements: Node.js v20+, direnv, PNPM v10

Quick start:

  1. Copy .envrc (example) to .envrc and add your Google API credentials
  2. Run pnpm install && pnpm dev
  3. Update your MCP configuration for development:
{
  "mcpServers": {
    "googleImagesSearch": {
      "command": "node",
      "args": ["/absolute/path/to/project/src/index.js", "--debug", "--pretty-print"],
      "env": {
        "API_KEY": "your-google-api-key-here",
        "SEARCH_ENGINE_ID": "your-search-engine-id-here"
      },
      "autoApprove": ["search_image", "persist_image"]
    }
  }
}

Debug and logging options:

  • No --debug flag provided - logging is disabled
  • --debug without argument - enable logging into debug.log in current working directory the running MCP
  • --debug /absolute/path/to/debug.log - enable logging and write logs to the specified absolute path
  • --pretty-print - Format logs for better readability (formatted JSON output)

note: only absolute path is allowed when providing a path to --debug. Relative paths will cause the server to exit with an error!

Writing TypeScript code:

The pnpm dev auto-recompile all changes to .ts files. But you must reload your MCP server manually for changes to be reflected in your IDE.

Use pnpm dev:inspector for interactive testing in the browser.

🛠️ Available Tools

🔍 search_image - Find images using Google's vast database

  • query (required) - What you're looking for
  • count (1-10, default: 2) - How many results
  • safe ('off'/'medium'/'high') - Filter level
  • startIndex - For pagination

💾 persist_image - Download and save images to your project

  • url (required) - Image URL to download
  • targetPath (required) - Where to save it (folder or full path)

Security features: Path validation, MIME type checking, 10MB size limit, supports all major image formats (JPEG, PNG, GIF, WebP, SVG, etc.)

🔗 Links: GitHub • NPM • Issues