Brave Search MCP con soporte SSE

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de Brave Search con integración de Eventos Enviados por el Servidor (SSE). Puede implementarse en Coolify y usarse como un servicio de búsqueda en tiempo real.

Características

Integración de la API de Brave Search a través de MCP
Resultados de búsqueda en tiempo real mediante SSE
Compatible con Docker y Coolify
Implementación de TypeScript
Punto final SSE de Express.js

Prerrequisitos

Clave API de Brave Search
Node.js 18+
Docker (para implementación en contenedores)
Instancia de Coolify

Desarrollo local

Clonar el repositorio
Crea un archivo .env con tu clave API de Brave:
BRAVE_API_KEY=your_api_key_here PORT=3001
Instalar dependencias:
npm install
Iniciar servidor de desarrollo:
npm run dev

Implementación de Docker

Construya y ejecute usando docker-compose:
docker-compose up --build

Implementación de Coolify

En tu panel de Coolify, crea un nuevo servicio
Seleccione "Implementar desde la fuente"
Configure lo siguiente:
- URL del repositorio: la URL de su repositorio
- Rama: principal
- Comando de compilación: npm run build
- Comando de inicio: npm start
- Puerto: 3001
- Variables de entorno:
  - BRAVE_API_KEY=su_clave_api_aquí
  - PUERTO=3001

Uso de la integración SSE

Punto final de SSE

GET http://your-server:3001/sse

El punto de conexión SSE proporciona resultados de búsqueda en tiempo real. Conéctese a él mediante la API EventSource:

const eventSource = new EventSource('http://your-server:3001/sse');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // Handle the search results
  console.log(data);
};

eventSource.onerror = (error) => {
  console.error('SSE Error:', error);
  eventSource.close();
};

Punto final de mensajes

POST http://your-server:3001/messages
Content-Type: application/json

{
  "query": "your search query",
  "count": 10  // optional, default: 10, max: 20
}

Utilice este punto final para activar búsquedas que se transmitirán a todos los clientes SSE conectados.

Uso de MCP

El servidor proporciona la siguiente herramienta MCP:

brave_web_search : Realiza una búsqueda web utilizando la API de búsqueda Brave
{ query: string; // Search query count?: number; // Number of results (1-20, default: 10) }

Manejo de errores

El servidor transmite errores a todos los clientes SSE conectados
Los errores se formatean así:
{ "type": "error", "error": "error message" }

Notas

La conexión SSE permanecerá abierta hasta que el cliente la cierre.
Cada resultado de búsqueda se transmite a todos los clientes conectados
El servidor gestiona automáticamente las desconexiones y la limpieza.
Para la implementación de producción, considere implementar la autenticación para el punto final de mensajes

Brave Search MCP Server

Integrations