Web Search Mcp Server

What is Web Search?

Web search refers to the process of using a search engine to find information on the internet. It allows users to enter queries and receive a list of relevant results. The web search tool developed by pskill9, known as ### web-search, offers a unique feature: it enables users to perform searches using Google's search engine without the need for API keys. This makes it accessible and easy to use for anyone looking to find information online.

Features of Web Search

• No API Keys Required: Users can perform searches without the hassle of obtaining API keys, making it user-friendly.
• Free Access: The tool is available for public use, allowing anyone to utilize its capabilities without any cost.
• Google Search Integration: Leverages Google's powerful search algorithms to provide accurate and relevant search results.
• User-Friendly Interface: Designed for ease of use, making it accessible for users of all technical levels.
• Open Source: The project is hosted on GitHub, allowing developers to contribute, fork, and improve the tool.

How to Use Web Search

1. Access the Tool: Navigate to the web-search repository on GitHub.
2. Clone or Download: You can either clone the repository using Git or download the ZIP file to your local machine.
3. Run the Application: Follow the instructions provided in the repository to set up and run the application.
4. Enter Your Query: Use the search bar to enter your query and hit enter.
5. View Results: Browse through the results displayed, which are powered by Google.

Frequently Asked Questions

Is there a cost to use web-search?

No, web-search is completely free to use.

Do I need to register or sign in to use the tool?

No registration or sign-in is required to perform searches.

Can I contribute to the web-search project?

Yes! The project is open source, and contributions are welcome. You can fork the repository and submit pull requests.

What kind of queries can I perform?

You can perform any type of query that you would normally enter into Google, including text searches, questions, and more.

Is there any limit to the number of searches I can perform?

There are no limits imposed on the number of searches you can conduct using the web-search tool.

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

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

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:

   • 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!