MCP Brave Search

🚀 Brave Search MCP Server

An MCP server implementation integrating the Brave Search API, offering both web and local search functionalities.

🚀 Quick Start

The Brave Search MCP Server integrates the Brave Search API, providing web and local search capabilities. It supports various search types, flexible filtering, and intelligent fallback mechanisms.

✨ Features

• Web Search: Supports general queries, news, and articles, with pagination and freshness control.
• Local Search: Finds businesses, restaurants, and services, with detailed information.
• Flexible Filtering: Controls result types, safety levels, and content freshness.
• Intelligent Fallback: Automatically falls back to web search when local search yields no results.

📦 Installation

Obtain an API Key

1. Sign up at Brave Search API Account.
2. Select a plan (the free tier offers 2,000 queries per month).
3. Generate your API key from the developer console here.

Usage with Claude Desktop

Add the following content to claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Build

Build with Docker:

docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .

💻 Usage Examples

Basic Usage

brave_web_search

# Perform a web search with pagination and filtering
# Input:
# - query (string): Search term
# - count (number, optional): Number of results per page (max 20)
# - offset (number, optional): Pagination offset (max 9)

brave_local_search

# Search for local businesses and services
# Input:
# - query (string): Local search term
# - count (number, optional): Number of results (max 20)
# Automatically falls back to web search when no local results are found

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.