semvec/pypi-packages huggingface dataset:
mcp-brave-search 0.1.1
MCP server for Brave Search API, providing web and local search capabilities
License: MIT
Requires Python: >=3.9

MCP Brave Search Server
An MCP (Model Context Protocol) server that integrates with the Brave Search API to provide web and local search capabilities for Large Language Models (LLMs).
Features

brave_web_search: Performs general web searches for news, articles, and online content.
brave_local_search: Searches for local businesses and places, with fallback to web search if no local results are found.
Rate limiting to respect Brave API constraints.
Asynchronous HTTP requests using httpx.

Installation
pip install mcp-brave-search

Requirements

Python 3.9 or higher
A Brave Search API key (set as BRAVE_API_KEY environment variable)

Setup

Obtain a Brave Search API key from Brave Search API.
Set the API key in a .env file or as an environment variable:export BRAVE_API_KEY="your-api-key"


Install the package:pip install mcp-brave-search



Usage
Run the server:
mcp-brave-search

To integrate with an MCP client like Claude Desktop, add the following to claude_desktop_config.json:
{
  "mcpServers": {
    "brave_search": {
      "command": "uvx",
      "args": ["mcp-brave-search"]
    }
  }
}

If you’re not using uvx, adjust the command to use python or the path to your Python executable:
json

{
  "mcpServers": {
    "brave_search": {
      "command": "python",
      "args": ["-m", "brave_search.server"]
    }
  }
}

Tools

brave_web_search: Search the web with pagination support.
Inputs: query (string), count (1-20, default 10), offset (0-9, default 0)
Example: brave_web_search(query="python tutorials", count=5)


brave_local_search: Search for local businesses or places.
Inputs: query (string), count (1-20, default 5)
Example: brave_local_search(query="pizza near Central Park")



Development
To contribute or modify the server:

Clone the repository:git clone https://github.com/your-repo/mcp-brave-search.git


Install dependencies:pip install -r requirements.txt


Run the server locally:python -m brave_search.server



License
MIT License