Web Search Iur

🚀 Web Search MCP Server

A Model Context Protocol (MCP) server that supports free web searches using Google search results without the need for an API key.

🚀 Quick Start

This MCP server enables you to conduct web searches leveraging Google search results without any API keys. It returns structured search results and offers configurable result numbers per search.

✨ Features

• Conduct web searches using Google search results.
• No API key or authentication is required.
• Return structured search results, including titles, URLs, and descriptions.
• Configurable number of results per search.

📦 Installation

1. Clone or download this repository.
2. Install the dependencies:

npm install

3. Build the server:

npm run build

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

Basic Usage

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

{
  "query": string,    // Search query
  "limit": number     // Optional: Number of results to return (Default: 5, Maximum: 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..."
  }
]

📚 Documentation

Limitations

Since this tool uses web scraping of Google search results, there are the following important limitations:

⚠️ Important Note

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

• Maintain a reasonable search frequency.
• Use the limit parameter with caution.
• Consider adding delays between searches if necessary.

2. Result Accuracy:

• The tool relies on Google's HTML structure, which may change.
• Some results may lack descriptions or other metadata.
• Complex search operators may not work as expected.

3. Legal Considerations:

• This tool is intended for personal use.
• Comply with Google's Terms of Service.
• Consider implementing appropriate rate limiting for your use case.

🤝 Contribution Guidelines

Issues and improvement requests are welcome!