Alexatnordnet MCP Google Custom Search Server

🚀 MCP Google Custom Search Server

A server based on the Model Context Protocol (MCP) that provides web search functionality through Google's Custom Search API. This server enables Large Language Models (LLMs) to perform web searches via a standardized interface.

🚀 Quick Start

1. Clone the repository:

   git clone https://github.com/yourusername/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
   

✨ Features

• Seamless integration with Google Custom Search API
• Implementation compliant with the Model Context Protocol (MCP)
• Secure type implementation using TypeScript
• Configuration via environment variables
• Input validation using Zod
• Configurable number of results (up to 10)
• Formatted search results including title, link, and description
• Error handling and validation
• Suitable for Claude Desktop and other MCP clients

📦 Installation

Prerequisites

Before you begin, ensure the following:

1. Enable the Custom Search API in the Google Cloud Console:

   • Visit the Google Cloud Console.
   • Enable the Custom Search API.
   • Create API credentials.

2. Obtain a Custom Search Engine ID:

   • Visit the Programmable Search Engine.
   • Create a new search engine.
   • Get your search engine ID.

3. Local development requirements:

   • Node.js (v18 or higher)
   • npm (provided with Node.js)

📚 Documentation

Configuration

Environment Variables

Claude Desktop Integration

Add the following to your Claude Desktop configuration file (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "servers": {
    "custom_search": {
      "type": "mcp",
      "host": "localhost",
      "port": "3000"
    }
  }
}

API Documentation

Search Tool

Parameters

• query: The keyword or phrase to search for.
• num_results: The number of results to return (default is 10).

Response Format

{
  "results": [
    {
      "title": "Result Title",
      "link": "Link URL",
      "description": "Result Description"
    }
  ]
}

Development Information

Project Structure

mcp-google-custom-search-server/
├── index.js          # Main application file
├── config.js        # Configuration file
└── package.json     # Dependencies and scripts

Available Scripts

• npm run build: Build the server.
• npm start: Start the server.

Testing

Test the server functionality using MCP Inspector. Run the following commands in your terminal:

npm install -g mcp-inspector
mcp-inspector

Enter the following to perform a search:

{
  "command": "search",
  "query": "MCP Protocol"
}