A powerful Model Context Protocol (MCP) server providing real-time web search capabilities through pluggable search providers. Currently integrated with the
- Real-Time Information Access: Enables AI assistants to retrieve up-to-date information from the web
- Pluggable Search Providers: Modular architecture allows for easy switching between different search engines
- Structured Output Format: Returns search results in a clean, consistent JSON format
- Smart Query Handling: Automatically categorizes queries and provides AI assistants with context-aware guidance
- Node.js: v16.x or newer
- npm: v7.x or newer
- Brave Search API Key: Required for accessing the Brave Search API
-
Clone the Repository:
git clone https://github.com/gabrimatic/mcp-web-search-tool.git cd mcp-web-search-tool
-
Install Dependencies:
npm install
-
Configure Environment Variables: Create a
.env
file in the project root:BRAVE_API_KEY=your_api_key_here MAX_RESULTS=10 # Optional: Default is 10 REQUEST_TIMEOUT=10000 # Optional: Default is 10000ms
-
Build the Project:
npm run build
npm start
node test-server.js
One of the most exciting aspects of this project is its seamless integration with the Claude Desktop app. This integration allows users to ask Claude questions that require real-time information, and Claude will automatically use the web search tool to provide up-to-date answers.
-
Create a
claude_desktop_config.json
file:{ "mcpServers": { "mcp-web-search": { "command": "node", "args": [ "/path/to/your/mcp-web-search-tool/build/index.js" ] } } }
-
Launch Claude Desktop with your configuration file.
-
Ask Claude questions requiring real-time information, and it will automatically use the web search tool.
Watch Claude in action using the MCP Web Search Tool for real-time AI browsing!
- "What are analysts saying about the MVP race after tonightβs NBA games?"
- "What are the latest news about artificial intelligence?"
- "What's the weather like in New York today?"
- "How is the stock market performing right now?"
- Tool Name:
web_search
- Description: Search the web for REAL-TIME information
- Necessarily For: Weather, current events, sports scores, stock market updates
- Parameters:
search_term
(string): The search term to look upprovider
(string, optional): Search provider (defaults to Brave)
The tool automatically categorizes queries into:
- Weather information
- Current events and news
- Sports scores and results
- Stock market and financial data
- Time-sensitive information
- General information seeking
By
Β© All rights reserved.
Read more about the MCP Web Search Tool, its capabilities, and how it enhances AI-driven web search in our detailed Medium article:
π