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): ``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:

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

1. 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

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