Web Search MCP Server

by williamvd4
6

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:
npm install
  1. Build the server:
npm run build
  1. Add the server to your MCP configuration:

For VSCode (Claude Dev Extension):

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

For Claude Desktop:

{ "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:

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

Example usage:

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

Example response:

[ { "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!

-
security - not tested
-
license - not tested
-
quality - not tested

Enables free web searching using Google search results with no API keys required, returning structured results with titles, URLs, and descriptions.

  1. Features
    1. Installation
      1. Usage
        1. Limitations
          1. Contributing

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
              Last updated -
              3
              64
              9
              JavaScript
              MIT License
              • Linux
            • A
              security
              A
              license
              A
              quality
              Enables search capabilities using a Google Custom Search Engine, allowing users to input a search term and retrieve search result titles, links, and snippets, while facilitating integration with other tools for content extraction and advanced search strategies.
              Last updated -
              1
              13
              Python
              The Unlicense
            • A
              security
              A
              license
              A
              quality
              Provides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.
              Last updated -
              2
              209
              17
              JavaScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              Provides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.
              Last updated -
              49
              Python
              MIT License
              • Linux
              • Apple

            View all related MCP servers

            ID: 3zbvl5opdo