MCP Server Search

What is MCP Server Search?

MCP Server Search is an MCP (Model Context Protocol) server that provides Google search functionality for AI models. It allows models to search for up-to-date information from the web, with caching, configurable delays, and retry mechanisms to avoid rate limiting.

How to use MCP Server Search?

Install via Docker: build the image, create ./logs and ./cache directories, and run the container with SSE enabled on port 8000. Configure Cline to connect to http://localhost:8000/sse. Use the google_search tool or prompt with a query and optional parameters like num_results (1–20), use_cache, and include_descriptions.

Key features of MCP Server Search

• Google search integration with file-based caching
• Configurable request delays and retries
• Support for simple and advanced searches (with descriptions)
• Throttling and randomization to be a good web citizen
• Exponential backoff on rate limiting (HTTP 429)
• Thread-safe access to cached results

Use cases of MCP Server Search

• AI models retrieving real-time web information
• Searching for current events or data without manual browsing
• Integrating search results into conversational AI responses
• Caching frequent searches to improve performance

FAQ from MCP Server Search

What dependencies does the server require?

Docker is the recommended installation method; the server runs on Python with dependencies defined in the Dockerfile.

Where are search results cached?

Results are cached in a file-based database at cache/google_cache.db (configurable via --cache-path), with thread-safe access.

What transport does the server use?

The server uses HTTP SSE (Server-Sent Events) on port 8000 at the /sse endpoint.

Can I configure the search delay and retries?

Yes, via command-line arguments: --request-delay (default 5 seconds) and --max-retries (default 3).

Is there rate limiting protection?

Yes, the server implements automatic request throttling, random user agent rotation, and exponential backoff on HTTP 429 responses.