Brave Search
About
Integrates with Brave Search API to enable web searches and local business lookups via natural language queries.
Details
- Author
- arben-adm
- Repository
- arben-adm/brave-mcp-search
- GitHub stars
- 9
- License
- MIT License
- Categories
- Search, Other, AI, Design, API, Frontend, Infrastructure
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Brave SearchCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
path-to/mcp-python/brave-mcp-search/src -
Argument 3
run -
Argument 4
server.py
Environment-
BRAVE_API_KEY
YOUR_BRAVE_API_KEY_HERE
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. 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\\brave-mcp-search\\src",
"run",
"server.py"
],
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
}
}
}
}
Replace YOUR_BRAVE_API_KEY_HERE with your actual Brave API key.
2. Start the Brave Search MCP server by running your MCP-compatible AI assistant with the updated configuration.
3. The server will now be running and ready to accept requests from MCP clients.
4. You can now use the Brave Search functionality in your MCP-compatible AI assistant (like Claude) by invoking the available tools.
To install Brave Search MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude
1. Clone the repository:
git clone https://github.com/your-username/brave-search-mcp.git
cd brave-search-mcp
2. 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
3. Set up your Brave Search API key:
export BRAVE_API_KEY=your_api_key_here
On Windows, use:
set BRAVE_API_KEY=your_api_key_herebrave_web_search
Performs a web search using the Brave Search API.
brave_local_search
Searches for local businesses and places.
The server provides two main tools:
1. brave_web_search: Performs a web search using the Brave Search API.
2. brave_local_search: Searches for local businesses and places.
Refer to the tool docstrings in src/server.py for detailed usage information.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"brave search": {
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
},
"args": [
"--directory",
"path-to/mcp-python/brave-mcp-search/src",
"run",
"server.py"
],
"command": "uv"
}
}
}Linux
{
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
},
"args": [
"--directory",
"path-to/mcp-python/brave-mcp-search/src",
"run",
"server.py"
],
"command": "uv"
}Macos
{
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
},
"args": [
"--directory",
"path-to/mcp-python/brave-mcp-search/src",
"run",
"server.py"
],
"command": "uv"
}Windows
{
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
},
"args": [
"--directory",
"path-to\\mcp-python\\brave-mcp-search\\src",
"run",
"server.py"
],
"command": "uv"
}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 @arben-adm/brave-mcp-search --client claude
git clone https://github.com/your-username/brave-search-mcp.git cd brave-search-mcp
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\\brave-mcp-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
- 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.
