Provides real-time web search capabilities through Google Custom Search, allowing AI agents to retrieve current information from the internet with configurable result quantities.
Leverages Google Cloud's Custom Search API for performing web searches, requiring API keys and a Custom Search Engine ID from Google Cloud Console.
google-search-mcp
A Model Context Protocol (MCP) server that provides Google Search functionality.
🚀 Features
StreamableHTTP Transport: High-performance and scalable HTTP communication
Google Custom Search: Real-time web search capabilities
Secure: Proper authentication and error handling
Health Check: Standard health check endpoint support
Related MCP server: searchAPI-mcp
🛠 Requirements
Node.js 18 or higher
Google Custom Search API key
📦 Setup
1. Install dependencies
2. Set environment variables
3. Local development
🔧 API Endpoints
Once the server is running, the following endpoints are available:
Endpoint | Description |
| MCP protocol communication |
| Health check |
| Status |
🔌 Client Configuration
Cursor IDE / Claude Desktop Configuration
Example configuration for using the server from MCP clients:
📊 Monitoring
Health Check
🧪 Available Tools
search
Performs a web search using the Google Search API.
Parameters:
query(string, required): Search querynum(number, optional): Number of results to return (1-10, default: 5)
Example:
🔑 Google Custom Search Setup
Go to Google Cloud Console
Create a new project or select an existing one
Enable the Custom Search API
Create credentials (API Key)
Set up a Custom Search Engine
Get your Search Engine ID
📝 Development
Build
Lint
Format
Note: This server is designed for StreamableHTTP mode only. It does not support stdio mode.