Serper Google Search MCP Server

A Model Context Protocol server that provides Google search capabilities through the Serper API. This server enables easy integration of Google search functionality into your MCP-enabled applications.

✨ Features

🌐 Powerful Google search integration through Serper API
🔄 Rich response data including:
- Knowledge Graph information
- Organic search results
- "People Also Ask" questions
- Related searches
🛠 Configurable search parameters:
- Country targeting
- Language selection
- Result count customization
- Autocorrect options
🔒 Secure API key handling
⚡️ Rate limiting and caching support
📝 TypeScript support with full type definitions

🚀 Installation

Clone the repository:

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server

Install dependencies:

pnpm install

Build the server:

pnpm run build

⚙️ Configuration

Get your Serper API key from Serper.dev
Create a .env file in the root directory:

SERPER_API_KEY=your_api_key_here

🔌 Integration

Claude Desktop

Add the server config to your Claude Desktop configuration:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search-server": {
      "command": "/path/to/serper-search-server/build/index.js",
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠 Usage

The server provides a powerful search tool with the following parameters:

{
  "query": string,          // Search query
  "numResults"?: number,    // Number of results (default: 10, max: 100)
  "gl"?: string,           // Country code (e.g., "us", "uk")
  "hl"?: string,           // Language code (e.g., "en", "es")
  "autocorrect"?: boolean, // Enable autocorrect (default: true)
  "type"?: "search"        // Search type (more types coming soon)
}

Example Response

The search results include rich data:

{
  "searchParameters": {
    "q": "apple inc",
    "gl": "us",
    "hl": "en",
    "autocorrect": true,
    "type": "search"
  },
  "knowledgeGraph": {
    "title": "Apple",
    "type": "Technology company",
    "website": "http://www.apple.com/",
    "description": "Apple Inc. is an American multinational technology company...",
    "attributes": {
      "Headquarters": "Cupertino, CA",
      "CEO": "Tim Cook (Aug 24, 2011–)",
      "Founded": "April 1, 1976, Los Altos, CA"
    }
  },
  "organic": [
    {
      "title": "Apple",
      "link": "https://www.apple.com/",
      "snippet": "Discover the innovative world of Apple...",
      "position": 1
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "What does Apple Inc mean?",
      "snippet": "Apple Inc., formerly Apple Computer, Inc....",
      "link": "https://www.britannica.com/topic/Apple-Inc"
    }
  ],
  "relatedSearches": [
    {
      "query": "Who invented the iPhone"
    }
  ]
}

🔍 Response Types

Knowledge Graph

Contains entity information when available:

Title and type
Website URL
Description
Key attributes

Organic Results

List of search results including:

Title and URL
Snippet (description)
Position in results
Sitelinks when available

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

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

🙏 Acknowledgments

Serper API for providing the Google search capabilities
Model Context Protocol for the MCP framework