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:
2. Keep searches to a reasonable frequency
3. Use the limit parameter judiciously

4. Consider implementing delays between searches if needed

5. Result Accuracy:

6. The tool relies on Google's HTML structure, which may change
7. Some results might be missing descriptions or other metadata

8. Complex search operators may not work as expected

9. Legal Considerations:

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

Contributing

Feel free to submit issues and enhancement requests!