Google Search

by modelcontextprotocol-servers

1 stars
146 downloads
Not rated
GitHub

About

Bypasses Google search anti-bot mechanisms with advanced browser fingerprinting and automatic CAPTCHA handling to provide real-time, multi-language search capabilities for external tools.

Details

Author
modelcontextprotocol-servers
Repository
modelcontextprotocol-servers/google-search-mcp
GitHub stars
1
Downloads
146
Categories
AI, Design, Developer Tools, Search, Infrastructure
Tags
#web

- Anti-Bot Bypass: Uses browser fingerprint spoofing and real user behavior simulation to avoid detection
- Automatic CAPTCHA Handling: Switches to headed mode when encountering CAPTCHAs, allowing users to complete verification
- State Persistence: Saves browser session state to reduce the need for repeated verification
- Adaptability: Uses multiple selector combinations to adapt to changes in Google search pages
- MCP Integration: Implements the Model Context Protocol for easy integration with AI assistants
- Multi-language Support: Supports search results in different languages and regions

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Google Search
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @mcp-server/google-search-mcp@latest

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

yarn start

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google search": {
            "env": {},
            "args": [
                "-y",
                "@mcp-server/google-search-mcp@latest"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@mcp-server/google-search-mcp@latest"
    ],
    "command": "cmd"
}

Google Search MCP

Model Context Protocol server for google search.
A Playwright-based Model Context Protocol (MCP) tool that bypasses search engine anti-bot mechanisms, performs Google searches, and extracts results, providing real-time search capabilities for AI assistants like Claude and Cursor.

Features

- Anti-Bot Bypass: Uses browser fingerprint spoofing and real user behavior simulation to avoid detection
- Automatic CAPTCHA Handling: Switches to headed mode when encountering CAPTCHAs, allowing users to complete verification
- State Persistence: Saves browser session state to reduce the need for repeated verification
- Adaptability: Uses multiple selector combinations to adapt to changes in Google search pages
- MCP Integration: Implements the Model Context Protocol for easy integration with AI assistants
- Multi-language Support: Supports search results in different languages and regions

Using with Cursor

Installation - Globally

Run the MCP server using npx:

npx -y @mcp-server/google-search-mcp@latest

In your Cursor IDE

1. Go to Cursor Settings > MCP
2. Click + Add New MCP Server
3. Fill in the form:
- Name: google-search (or any name you prefer)
- Type: command
- Command: npx -y @mcp-server/google-search-mcp@latest

Installation - Project-specific

Add an .cursor/mcp.json file to your project:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
      ]
    }
  }
}

Development

yarn install

Build the project

yarn build

Usage

Running as an MCP Server

yarn start

Using with MCP Inspector

To debug the server, you can use the MCP Inspector:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.