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

3. Build the server:

bash
npm run build

4. 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!