Brave Search
About
A server for Brave Search, enabling web search capabilities via its API.
Details
- Author
- thomasvan
- Categories
- Search, Other
Jump to
Setup
Install Brave Search in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/thomasvan/mcp-brave-search
Follow the installation instructions in the repository README, then restart your MCP client.
This project implements a Model Context Protocol (MCP) server for Brave Search, allowing integration with AI assistants like Claude.
- Python 3.11+
- uv- A fast Python package installer and resolver
To install Brave Search MCP server for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install @thomasvan/mcp-brave-search --client claude
git clone https://github.com/thomasvan/mcp-brave-search.git cd mcp-brave-search
Create a virtual environment and install dependencies using uv:
uv venv source .venv/bin/activate # On Windows, use: .venv\Scripts\activate uv pip install -r requirements.txt
On Windows, use:set BRAVE_API_KEY=your_api_key_here
-
Configure your MCP settings file (e.g.,claude_desktop_config.json) to include the Brave Search MCP server:
{ "mcpServers": { "brave-search": { "command": "uv", "args": [ "--directory", "path-to\\mcp-python\\mcp-brave-search\\src", "run", "server.py" ], "env": { "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE" } } } }
ReplaceYOUR_BRAVE_API_KEY_HEREwith your actual Brave API key.
Start the Brave Search MCP server by running your MCP-compatible AI assistant with the updated configuration.
The server will now be running and ready to accept requests from MCP clients.
You can now use the Brave Search functionality in your MCP-compatible AI assistant (like Claude) by invoking the available tools.
- brave_web_search: Performs a web search using the Brave Search API.
- brave_local_search: Searches for local businesses and places.
Refer to the tool docstrings insrc/server.pyfor detailed usage information.
- Modify the code in thesrcdirectory as needed.
- Update therequirements.txtfile if you add or remove dependencies:
uv pip freeze > requirements.txt
The project includes both unit tests and integration tests:
uv pip install pytest pytest-asyncio pytest-cov
Unit tests can be run without an API key and use mocks to simulate API responses:
# Run all unit tests python -m pytest tests/unit/ # Run with verbose output python -m pytest tests/unit/ -v
Integration tests require a valid Brave API key and make real API calls:
# Run integration tests with your API key BRAVE_API_KEY_INTEGRATION="your_api_key_here" python -m pytest tests/integration/ -v
python -m pytest --cov=src/mcp_brave_search
- Ensure your Brave API key is correctly set.
- Check that all dependencies are installed.
- Verify that you're using a compatible Python version.
- If you make changes to the code, make sure to restart the server.
This project is licensed under the MIT License - see theLICENSEfile for details.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Fetch, convert, and search AWS documentation pages, with recommendations for related content.
Search campgrounds around the world on campertunity, check availability, and provide booking links.
The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.
All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.
MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.
At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.
Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/
Search the web using Kagi's search API
Research tools, including a Sqlite-backed document stash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
