web-search

web-search

A Model Context Protocol server enabling web search via Google without API keys.

277
Stars
96
Forks
277
Watchers
6
Issues
Web Search MCP Server is a Model Context Protocol server that enables free web searching through Google by scraping public search results, bypassing the need for API keys or authentication. It returns structured search results including titles, URLs, and descriptions, and allows users to configure the number of results per query. Designed to integrate easily with various MCP-compatible tools, it offers straightforward configuration for development environments like VSCode and Claude Desktop. The tool is intended for personal use and implements rate limiting guidance to comply with responsible usage.

Key Features

Google search results scraping
No API key or authentication needed
Returns structured JSON results
Configurable number of results per query
Single tool interface named 'search'
Integration with VSCode and Claude Desktop via MCP
Easy command-line setup and configuration
Supports optional result limits per search
Detailed error and limitation documentation
Open for enhancement and issue submission

Use Cases

On-demand web search integration in AI assistants
Enhancing developer workflow with quick web lookups
Incorporating latest web data into model context
Providing research results in applications without cost
Rapid prototyping for AI tools needing live web information
Personal knowledge augmentation via search automation
Data enrichment for chatbots and language models
Testing context-aware model features using web data
Lightweight search for desktop AI tools
Context injection during code or document generation

README

Web Search MCP Server

A Model Context Protocol (MCP) server that enables free web searching using Google search results, with no API keys required.

Features

  • Search the web using Google search results
  • No API keys or authentication required
  • Returns structured results with titles, URLs, and descriptions
  • Configurable number of results per search

Installation

  1. Clone or download this repository
  2. Install dependencies:
bash
npm install
  1. Build the server:
bash
npm run build
  1. Add the server to your MCP configuration:

For VSCode (Claude Dev Extension):

json
{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

For Claude Desktop:

json
{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Usage

The server provides a single tool named search that accepts the following parameters:

typescript
{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

Example usage:

typescript
use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

Example response:

json
[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

Limitations

Since this tool uses web scraping of Google search results, there are some important limitations to be aware of:

  1. Rate Limiting: Google may temporarily block requests if too many searches are performed in a short time. To avoid this:

    • Keep searches to a reasonable frequency
    • Use the limit parameter judiciously
    • Consider implementing delays between searches if needed
  2. Result Accuracy:

    • The tool relies on Google's HTML structure, which may change
    • Some results might be missing descriptions or other metadata
    • Complex search operators may not work as expected
  3. Legal Considerations:

    • This tool is intended for personal use
    • Respect Google's terms of service
    • Consider implementing appropriate rate limiting for your use case

Contributing

Feel free to submit issues and enhancement requests!

Star History

Star History Chart

Repository Owner

pskill9
pskill9

User

Repository Details

Language JavaScript
Default Branch main
Size 9 KB
Contributors 1
MCP Verified Sep 5, 2025

Programming Languages

JavaScript
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • WebSearch-MCP

    WebSearch-MCP

    Real-time web search for AI assistants via Model Context Protocol.

    WebSearch-MCP is a Model Context Protocol (MCP) server that enables real-time web search capabilities for AI assistants through the stdio transport. It connects with a web crawler API to retrieve up-to-date search results and serves these results to AI models like Claude. The solution offers straightforward configuration and seamless integration with various MCP clients, enhancing AI model access to current and relevant external information.

    • 19
    • MCP
    • mnhlt/WebSearch-MCP
  • G-Search MCP

    G-Search MCP

    Parallel Google search server with MCP support for structured AI context.

    G-Search MCP is a server for executing parallel Google searches optimized for use with AI tools through the Model Context Protocol. It efficiently handles multiple queries at once, simulates realistic user behavior to evade detection, and returns well-structured JSON responses. The server is configurable, supports parameter tuning like search limits and timeouts, and is designed for seamless integration in AI-driven environments such as Claude Desktop.

    • 224
    • MCP
    • jae-jae/g-search-mcp
  • MCP Web Research Server

    MCP Web Research Server

    Bring real-time web research and Google search capabilities into Claude using MCP.

    MCP Web Research Server acts as a Model Context Protocol (MCP) server, seamlessly integrating web research functionalities with Claude Desktop. It enables Google search, webpage content extraction, research session tracking, and screenshot capture, all accessible directly from Claude. The server supports interactive and guided research sessions, exposing session data and screenshots as MCP resources for enhanced context-aware AI interactions.

    • 284
    • MCP
    • mzxrai/mcp-webresearch
  • Brave Search MCP Server

    Brave Search MCP Server

    MCP integration for web, image, news, video, and local search via Brave Search API.

    Implements a Model Context Protocol server that connects with the Brave Search API, enabling AI systems to perform comprehensive web, image, news, video, and local points of interest searches. Provides standardized MCP tools for various search types, each supporting advanced filtering parameters. Designed for easy integration in context-aware model interfaces such as Claude Code.

    • 86
    • MCP
    • mikechao/brave-search-mcp
  • DuckDuckGo Search MCP Server

    DuckDuckGo Search MCP Server

    A Model Context Protocol server for DuckDuckGo web search and intelligent content retrieval.

    DuckDuckGo Search MCP Server provides web search capabilities through DuckDuckGo, with advanced content fetching and parsing tailored for large language models. It supports rate limiting, error handling, and delivers results in an LLM-friendly format. The server is designed for seamless integration with AI applications and tools like Claude Desktop, enabling enhanced web search and content extraction through the Model Context Protocol.

    • 637
    • MCP
    • nickclyde/duckduckgo-mcp-server
  • Open-WebSearch MCP Server

    Open-WebSearch MCP Server

    Multi-engine web search MCP server without API keys

    Open-WebSearch MCP Server is a Model Context Protocol (MCP) compliant server offering web search functionalities using multiple search engines without the need for API keys or authentication. It provides structured search results with titles, URLs, and descriptions, and enables fetching of article content from supported sources such as CSDN and GitHub. The server supports extensive configuration through environment variables, including proxy settings and search engine customization. Designed for flexibility, it operates in both HTTP and stdio modes, making it suitable for integration into larger systems.

    • 463
    • MCP
    • Aas-ee/open-webSearch
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results