MCP Web Search Tool

🚀 MCP Web Search Tool

A powerful Model Context Protocol (MCP) server that provides real-time web search functionality through pluggable search providers. Currently integrated with the Brave Search API.

✨ Features

• Real-time Information Access: Enables AI assistants to retrieve the latest web information.
• Pluggable Search Providers: A modular architecture that allows easy switching between different search engines.
• Structured Output Format: Returns search results in a clean and consistent JSON format.
• Intelligent Query Processing: Automatically classifies queries and provides context-aware guidance for AI assistants.

📋 Requirements

• Node.js: v16.x or higher.
• npm: v7.x or higher.
• Brave Search API Key: Required to access the Brave Search API.

🚀 Installation

1. Clone the repository:

   git clone https://github.com/gabrimatic/mcp-web-search-tool.git
   cd mcp-web-search-tool
   

2. Install dependencies:

   npm install
   

3. Configure environment variables: Create a .env file in the project root directory:

   BRAVE_API_KEY=your_api_key_here
   MAX_RESULTS=10 # Optional: Default is 10
   REQUEST_TIMEOUT=10000 # Optional: Default is 10000ms
   

4. Build the project:

   npm run build
   

💻 Usage

Start the server

npm start

Test the server

node test-server.js

Integration with Claude Desktop App (Optional)

One of the most exciting aspects of this project is its seamless integration with the Claude desktop app. This integration allows users to ask questions that require real-time information, and Claude will automatically use the web search tool to provide the latest answers.

Configuration

1. Create a claude_desktop_config.json file:

   {
     "mcpServers": {
       "mcp-web-search": {
         "command": "node",
         "args": [
           "/path/to/your/mcp-web-search-tool/build/index.js"
         ]
       }
     }
   }
   

2. Start the Claude desktop app with the configuration file.

3. Ask any question that requires real-time information, and Claude will automatically use the web search tool.

🎥 Video Demo

Watch Claude in action using the MCP web search tool for real-time AI browsing!

📺 Claude + MCP Web Search – Live Demo