Brave Search

Um servidor para o Brave Search, permitindo integração com assistentes de IA como o Claude.

Documentação

Servidor MCP do Brave Search

Este projeto implementa um servidor Model Context Protocol (MCP) para o Brave Search, permitindo integração com assistentes de IA como o Claude.

Pré-requisitos

Python 3.11+
uv - Um instalador e resolvedor de pacotes Python rápido

Instalação

Instalando via Smithery

Para instalar o servidor MCP do Brave Search para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

Instalação Manual

Clone o repositório:

git clone https://github.com/your-username/brave-search-mcp.git
cd brave-search-mcp

Crie um ambiente virtual e instale as dependências usando uv:

uv venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
uv pip install -r requirements.txt

Configure sua chave de API do Brave Search:
```
export BRAVE_API_KEY=your_api_key_here
```
No Windows, use: set BRAVE_API_KEY=your_api_key_here

Uso

Configure seu arquivo de configurações MCP (por exemplo, claude_desktop_config.json) para incluir o servidor MCP do Brave Search:

{
  "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"
      }
    }
  }
}

Substitua YOUR_BRAVE_API_KEY_HERE pela sua chave real da API do Brave.

Inicie o servidor MCP do Brave Search executando seu assistente de IA compatível com MCP com a configuração atualizada.
O servidor agora estará em execução e pronto para aceitar solicitações de clientes MCP.
Agora você pode usar a funcionalidade do Brave Search no seu assistente de IA compatível com MCP (como o Claude) invocando as ferramentas disponíveis.

Ferramentas Disponíveis

O servidor fornece duas ferramentas principais:

brave_web_search: Realiza uma pesquisa na web usando a API do Brave Search.
brave_local_search: Pesquisa por empresas e lugares locais.

Consulte as docstrings das ferramentas em src/server.py para obter informações detalhadas de uso.

Desenvolvimento

Para fazer alterações no projeto:

Modifique o código no diretório src conforme necessário.
Atualize o arquivo requirements.txt se você adicionar ou remover dependências:
```
uv pip freeze > requirements.txt
```
Reinicie o servidor para aplicar as alterações.

Solução de Problemas

Se você encontrar algum problema:

Certifique-se de que sua chave de API do Brave esteja configurada corretamente.
Verifique se todas as dependências estão instaladas.
Confirme que você está usando uma versão compatível do Python.
Se você fizer alterações no código, certifique-se de reiniciar o servidor.

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.