Skip to main content
Glama

MCP Google Custom Search Server

by limklister

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

  • Seamless integration with Google Custom Search API
  • Model Context Protocol (MCP) compliant server implementation
  • Type-safe implementation using TypeScript
  • Environment variable configuration
  • Input validation using Zod
  • Configurable search results (up to 10 per query)
  • Formatted search results including titles, URLs, and descriptions
  • Error handling and validation
  • Compatible with Claude Desktop and other MCP clients

📋 Prerequisites

Before you begin, ensure you have:

  1. A Google Cloud Project with Custom Search API enabled
  2. A Custom Search Engine ID
  3. Local development requirements:
    • Node.js (v18 or higher)
    • npm (comes with Node.js)

🚀 Quick Start

  1. Clone the repository:
    git clone https://github.com/limklister/mcp-google-custom-search-server.git cd mcp-google-custom-search-server
  2. Install dependencies:
    npm install
  3. Create a .env file:
    GOOGLE_API_KEY=your-api-key GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id
  4. Build the server:
    npm run build
  5. Start the server:
    npm start

🔧 Configuration

Environment Variables

VariableDescriptionRequired
GOOGLE_API_KEYYour Google Custom Search API keyYes
GOOGLE_SEARCH_ENGINE_IDYour Custom Search Engine IDYes

Claude Desktop Integration

Add this configuration to your Claude Desktop config file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "google-search": { "command": "node", "args": [ "/absolute/path/to/mcp-google-custom-search-server/build/index.js" ], "env": { "GOOGLE_API_KEY": "your-api-key", "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id" } } } }

📖 API Reference

Available Tools

Performs a web search using Google Custom Search API.

Parameters:

  • query (string, required): The search query to execute
  • numResults (number, optional): Number of results to return
    • Default: 5
    • Maximum: 10

Example Response:

Result 1: Title: Example Search Result URL: https://example.com Description: This is an example search result description --- Result 2: ...

🛠️ Development

Project Structure

mcp-google-custom-search-server/ ├── src/ │ └── index.ts # Main server implementation ├── build/ # Compiled JavaScript output ├── .env # Environment variables ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # Project documentation

Available Scripts

  • npm run build: Compile TypeScript to JavaScript
  • npm start: Start the MCP server
  • npm run dev: Watch mode for development

Testing

  1. Using MCP Inspector:
    npx @modelcontextprotocol/inspector node build/index.js
  2. Manual testing with example queries:
    # After starting the server {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built with Model Context Protocol (MCP)
  • Uses Google's Custom Search API
  • Inspired by the need for better search capabilities in LLM applications
Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

LLM が標準化されたインターフェースを通じて Google のカスタム検索 API を使用して Web 検索を実行できるようにするモデル コンテキスト プロトコル サーバー。

  1. 🌟 特徴
    1. 📋 前提条件
      1. 🚀 クイックスタート
        1. 🔧 構成
          1. 環境変数
          2. クロードデスクトップ統合
        2. 📖 APIリファレンス
          1. 利用可能なツール
        3. 🛠️ 開発
          1. プロジェクト構造
          2. 利用可能なスクリプト
          3. テスト
        4. 📝 ライセンス
          1. 🙏 謝辞

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.
              Last updated -
              13
              12
              • Linux
              • Apple
            • 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
              8
              1
              • Apple
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables LLM clients like VSCode, Copilot, and Claude Desktop to search the web using Google Programmable Search Engine API.
              Last updated -
              1
              56
              5
              Apache 2.0
              • Apple
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables LLMs to perform web searches using Google's Gemini API and return synthesized responses with citations.
              Last updated -
              46
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/limklister/mcp-google-custom-search-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server