Google Search MCP Server Streamable HTTP

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

🛠 Requirements

Node.js 18 or higher
Google Custom Search API key

📦 Setup

1. Install dependencies

npm install

2. Set environment variables

GOOGLE_SEARCH_API_KEY=your_actual_google_search_api_key
GOOGLE_CSE_ID=your_actual_custom_search_engine_id

cp env.example .env

3. Local development

npm run dev

🔧 API Endpoints

Once the server is running, the following endpoints are available:

Endpoint	Description
`/mcp`	MCP protocol communication
`/health`	Health check
`/`	Status

🔌 Client Configuration

Cursor IDE / Claude Desktop Configuration

Example configuration for using the server from MCP clients:

{
  "mcpServers": {
    "google_search": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

📊 Monitoring

Health Check

curl http://localhost:3000/health

🧪 Available Tools

`search`

Performs a web search using the Google Search API.

Parameters:

query (string, required): Search query
num (number, optional): Number of results to return (1-10, default: 5)

Example:

{
  "name": "search",
  "arguments": {
    "query": "artificial intelligence",
    "num": 5
  }
}

🔑 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

npm run build

Lint

npm run lint

Format

npm run format

Note: This server is designed for StreamableHTTP mode only. It does not support stdio mode.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A Model Context Protocol (MCP) server that provides Google Search functionality with StreamableHTTP transport support.

Related MCP Servers

Search1API MCP Server
fatwang2
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.
Last updated -
5
206
111
TypeScript
MIT License
Google Search MCP Server
mixelpixx
A
security
F
license
A
quality
An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
Last updated -
3
167
52
TypeScript
searchAPI-mcp
RmMargt
-
security
A
license
-
quality
A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels and other services. This server enables AI assistants to access various search services through a unified interface.
Last updated -
48
Python
MIT License
MCP Server for Google Search
mcp-for-dev
A
security
F
license
A
quality
A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.
Last updated -
2
10
1
JavaScript

View all related MCP servers

Google Search MCP Server Streamable HTTP