Brave Search

Servidor MCP Brave Search

Uma implementação de servidor MCP que integra a API Brave Search, fornecendo recursos de pesquisa web e local.

Recursos

• Pesquisa Web: Consultas gerais, notícias, artigos, com paginação e controles de atualização
• Pesquisa Local: Encontre empresas, restaurantes e serviços com informações detalhadas
• Filtragem Flexível: Controle tipos de resultados, níveis de segurança e atualização do conteúdo
• Fallbacks Inteligentes: A pesquisa local automaticamente recorre à web quando nenhum resultado é encontrado

Ferramentas

• brave_web_search

  • Execute pesquisas web com paginação e filtragem
  • Entradas:
    • query (string): Termos de pesquisa
    • count (número, opcional): Resultados por página (máx. 20)
    • offset (número, opcional): Deslocamento de paginação (máx. 9)

• brave_local_search

  • Pesquise por empresas e serviços locais
  • Entradas:
    • query (string): Termos de pesquisa local
    • count (número, opcional): Número de resultados (máx. 20)
  • Recorre automaticamente à pesquisa web se nenhum resultado local for encontrado

Configuração

Obtendo uma Chave de API

1. Cadastre-se em uma conta da API Brave Search
2. Escolha um plano (nível gratuito disponível com 2.000 consultas/mês)
3. Gere sua chave de API no painel do desenvolvedor

Uso com Claude Desktop

Adicione isso ao seu 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"
      }
    }
  }
}

Uso com VS Code

Para instalação rápida, use os botões de instalação com um clique abaixo...

Para instalação manual, adicione o seguinte bloco JSON ao arquivo de Configurações do Usuário (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json no seu espaço de trabalho. Isso permitirá que você compartilhe a configuração com outras pessoas.

Observe que a chave mcp não é necessária no arquivo .vscode/mcp.json.

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

Build

Build Docker:

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

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.