mcp-google-custom-search-server

mcp-google-custom-search-server

23
cloud_platforms

The MCP Google Custom Search Server is a Model Context Protocol server enabling language learning models to perform web searches using Google's Custom Search API. It provides a standardized MCP interface with features like type-safety, environment configuration, and error handling.

MCP Google Custom Search Server

A Model Context Protocol (MCP) server that provides web search capabilities through Google's Custom Search API. This server enables Language Learning Models (LLMs) to perform web searches using a standardized interface.

🌟 Features

  • Integration with Google Custom Search API
  • MCP compliant server implementation
  • Type-safe implementation using TypeScript
  • Environment variable configuration
  • Input validation using Zod
  • Configurable search results
  • Formatted search results
  • Error handling
  • Compatible with Claude Desktop and MCP clients

📋 Prerequisites

  1. Google Cloud Project with Custom Search API enabled
  2. Custom Search Engine ID
  3. Local development requirements: Node.js and npm

🚀 Quick Start

  1. Clone the repository
  2. Install dependencies
  3. Create a .env file
  4. Build the server
  5. Start the server

🔧 Configuration

  • Environment variables: GOOGLE_API_KEY and GOOGLE_SEARCH_ENGINE_ID

📖 API Reference

Available Tools

search

Parameters: query and numResults.