Serper Search
About
Provides Google search results and AI-powered deep research using the Serper API.
Details
- Author
- nighttrek
- GitHub stars
- 47
- Downloads
- 429
- Categories
- Search, Other, API
- Tags
- #web-research
Jump to
- Google search integration through Serper API
- Rich search response: Knowledge Graph, organic results, People Also Ask, related searches
- AI-powered Deep Research tool with multi-step iterative research
- Configurable search parameters: country, language, result count, autocorrect
- Secure API key handling
- TypeScript support with full type definitions
Clone the repository, install dependencies with pnpm, build the server, then configure by adding your Serper API key in a .env file. Integrate with Claude Desktop by adding the server config to the claude_desktop_config.json file, specifying the path to the built index.js and the API key.
A Model Context Protocol server that provides Google search capabilities through the Serper API, along with an AI-powered Deep Research tool. This server enables easy integration of search and research functionality into your MCP-enabled applications.
- 🌐 Powerful Google search integration through Serper API
- 🔄 Rich search response data including:
- Knowledge Graph information
- Organic search results
- "People Also Ask" questions
- Related searches
- Performs multi-step, iterative research
- Generates sub-queries to explore topics thoroughly
- Synthesizes information from multiple sources
- Provides citations for all information
- Adjustable research depth levels
- Built-in quality metrics for continuous improvement
- Country targeting
- Language selection
- Result count customization
- Autocorrect options
git clone https://github.com/yourusername/serper-search-server.git cd serper-search-server
-
Get your Serper API key from Serper.dev USAGE_METRICS_KEY=your-custom-metrics-key # Optional USAGE_PROJECT_ID=your-custom-project-id # Optional METRICS_ENDPOINT=https://your-custom-host.com # Optional DISABLE_METRICS=false # Not recommended
See](https://serper.de)TELEMETRY.mdfor detailed information about:
- Quality metrics collection
- Performance monitoring
- Usage analytics
- Dashboard setup
- Continuous improvement
Add the server config to your Claude Desktop configuration:
MacOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%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" } } } }
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) }
For more comprehensive research needs, the server provides a deep research tool that performs multi-step research with the following parameters:
{ "query": string, // Research query or question "depth"?: "basic" | "standard" | "deep", // Research depth (default: "standard") "maxSources"?: number // Maximum sources to include (default: 10) }
- Breaks down complex queries into focused sub-queries
- Executes multiple searches to gather comprehensive information
- Uses AI to synthesize information from multiple sources
- Formats results with proper citations and references
- Adapts its research strategy based on intermediate results
- Collects anonymous quality metrics to improve search results
- basic: Quick overview (3-5 sources, ~5 min) Good for: Simple facts, quick definitions, straightforward questions
- standard: Comprehensive analysis (5-10 sources, ~10 min) Good for: Most research needs, balanced depth and speed
- deep: Exhaustive research (10+ sources, ~15-20 min) Good for: Complex topics, academic research, thorough analysis
{ "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" } ] }
Contains entity information when available:
- Title and type
- Website URL
- Description
- Key attributes
- Title and URL
- Snippet (description)
- Position in results
- Sitelinks when available
- Question text
- Answer snippet
- Source link
List of related search queries users often make.
The Deep Research tool includes integrated quality metrics:
- Research process metrics
- Performance monitoring
- Issue tracking
- Usage patterns
- Result quality indicators
SeeTELEMETRY.mdfor detailed information about the metrics collected to improve search quality.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see theLICENSEfile for details.
- Serper APIfor providing the Google search capabilities
- Model Context Protocolfor the MCP framework
- PostHogfor analytics capabilities
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Search the web using Kagi's search API
Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.
A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.
Perform web, news, and image searches using the Microsoft Bing Search API.
An MCP server for web and local search using the Brave Search API.
Integrates the Brave Search API for both web and local search capabilities. Requires a BRAVE_API_KEY.
An MCP server for the Brave Search API, providing web and local search capabilities via a streaming SSE interface.
An MCP server for the Brave Search API, providing both web and local search capabilities.
Search for cocktail recipes using the cezzis.com API.
Free search API for AI agents — 105 engines, 22 profiles, 94.3% SimpleQA accuracy, MCP server with 5 tools
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
