Web Search MCP Server

1# Web Search MCP Server
2 
3A Model Context Protocol (MCP) server that enables free web searching using Google search results, with no API keys required.
4 
5## Features
6 
7- Search the web using Google search results
8- No API keys or authentication required
9- Returns structured results with titles, URLs, and descriptions
10- Configurable number of results per search
11 
12## Installation
13 
141. Clone or download this repository
152. Install dependencies:
16```bash
17npm install
18```
193. Build the server:
20```bash
21npm run build
22```
234. Add the server to your MCP configuration:
24 
25For VSCode (Claude Dev Extension):
26```json
27{
28  "mcpServers": {
29    "web-search": {
30      "command": "node",
31      "args": ["/path/to/web-search/build/index.js"]
32    }
33  }
34}
35```
36 
37For Claude Desktop:
38```json
39{
40  "mcpServers": {
41    "web-search": {
42      "command": "node",
43      "args": ["/path/to/web-search/build/index.js"]
44    }
45  }
46}
47```
48 
49## Usage
50 
51The server provides a single tool named `search` that accepts the following parameters:
52 
53```typescript
54{
55  "query": string,    // The search query
56  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
57}
58```
59 
60Example usage:
61```typescript
62use_mcp_tool({
63  server_name: "web-search",
64  tool_name: "search",
65  arguments: {
66    query: "your search query",
67    limit: 3  // optional
68  }
69})
70```
71 
72Example response:
73```json
74[
75  {
76    "title": "Example Search Result",
77    "url": "https://example.com",
78    "description": "Description of the search result..."
79  }
80]
81```
82 
83## Limitations
84 
85Since this tool uses web scraping of Google search results, there are some important limitations to be aware of:
86 
871. **Rate Limiting**: Google may temporarily block requests if too many searches are performed in a short time. To avoid this:
88   - Keep searches to a reasonable frequency
89   - Use the limit parameter judiciously
90   - Consider implementing delays between searches if needed
91 
922. **Result Accuracy**: 
93   - The tool relies on Google's HTML structure, which may change
94   - Some results might be missing descriptions or other metadata
95   - Complex search operators may not work as expected
96 
973. **Legal Considerations**:
98   - This tool is intended for personal use
99   - Respect Google's terms of service
100   - Consider implementing appropriate rate limiting for your use case
101 
102## Contributing
103 
104Feel free to submit issues and enhancement requests!
105