Servidor MCP de Brave Search

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

Prerrequisitos

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

Instalación

Instalación mediante herrería

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

Instalación manual

1. Clonar el repositorio:
   git clone https://github.com/your-username/brave-search-mcp.git cd brave-search-mcp
2. Cree un entorno virtual e instale dependencias usando uv:
   uv venv source .venv/bin/activate # On Windows, use: .venv\Scripts\activate uv pip install -r requirements.txt
3. Configura tu clave API de Brave Search:
   export BRAVE_API_KEY=your_api_key_here
   En Windows, use: set BRAVE_API_KEY=your_api_key_here

Uso

1. Configure su archivo de configuración 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" } } } }
   Reemplace YOUR_BRAVE_API_KEY_HERE con su clave API de Brave real.
2. Inicie el servidor MCP de Brave Search ejecutando su asistente de IA compatible con MCP con la configuración actualizada.
3. El servidor ahora estará funcionando y listo para aceptar solicitudes de clientes MCP.
4. Ahora puedes usar la funcionalidad Brave Search en tu asistente de IA compatible con MCP (como Claude) invocando las herramientas disponibles.

Herramientas disponibles

El servidor proporciona dos herramientas principales:

1. brave_web_search : realiza una búsqueda web utilizando la API de búsqueda Brave.
2. brave_local_search : busca negocios y lugares locales.

Consulte la documentación de la herramienta en src/server.py para obtener información detallada sobre su uso.

Desarrollo

Para realizar cambios en el proyecto:

1. Modifique el código en el directorio src según sea necesario.
2. Actualice el archivo requirements.txt si agrega o elimina dependencias:
   uv pip freeze > requirements.txt
3. Reinicie el servidor para aplicar los cambios.

Solución de problemas

Si encuentra algún problema:

1. Asegúrese de que su clave API de Brave esté configurada correctamente.
2. Verifique que todas las dependencias estén instaladas.
3. Verifique que esté utilizando una versión de Python compatible.
4. Si realiza cambios en el código, asegúrese de reiniciar el servidor.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.