Brave Search

Un servidor para Brave Search, que permite la integración con asistentes de IA como Claude.

Documentación

Servidor MCP de Brave Search

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para Brave Search, permitiendo la integración con asistentes de IA como Claude.

Requisitos previos

Python 3.11+
uv - Un instalador y resolutor de paquetes de Python rápido

Instalación

Instalación mediante Smithery

Para instalar el servidor MCP de Brave Search para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

Clona el repositorio:

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

Crea un entorno virtual e instala las dependencias usando uv:

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

Configura tu clave de API de Brave Search:
```
export BRAVE_API_KEY=your_api_key_here
```
En Windows, usa: set BRAVE_API_KEY=your_api_key_here

Uso

Configura tu archivo de ajustes de MCP (por ejemplo, claude_desktop_config.json) para incluir el servidor MCP de 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"
      }
    }
  }
}

Reemplaza YOUR_BRAVE_API_KEY_HERE con tu clave real de API de Brave.

Inicia el servidor MCP de Brave Search ejecutando tu asistente de IA compatible con MCP con la configuración actualizada.
El servidor ahora estará en ejecución y listo para aceptar solicitudes de clientes MCP.
Ahora puedes usar la funcionalidad de Brave Search en tu asistente de IA compatible con MCP (como Claude) invocando las herramientas disponibles.

Herramientas disponibles

El servidor proporciona dos herramientas principales:

brave_web_search: Realiza una búsqueda web usando la API de Brave Search.
brave_local_search: Busca negocios y lugares locales.

Consulta las cadenas de documentación de las herramientas en src/server.py para obtener información detallada de uso.

Desarrollo

Para realizar cambios en el proyecto:

Modifica el código en el directorio src según sea necesario.
Actualiza el archivo requirements.txt si agregas o eliminas dependencias:
```
uv pip freeze > requirements.txt
```
Reinicia el servidor para aplicar los cambios.

Solución de problemas

Si encuentras algún problema:

Asegúrate de que tu clave de API de Brave esté configurada correctamente.
Verifica que todas las dependencias estén instaladas.
Confirma que estás usando una versión compatible de Python.
Si realizas cambios en el código, asegúrate de reiniciar el servidor.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.