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

Related MCP server: WebSearch-MCP

Prerrequisitos

• Clave API de Brave Search

• Node.js 18+

• Docker (para implementación en contenedores)

• Instancia de Coolify

Desarrollo local

1. Clonar el repositorio

2. Crea un archivo .env con tu clave API de Brave:

   BRAVE_API_KEY=your_api_key_here
   PORT=3001

3. Instalar dependencias:

   npm install

4. Iniciar servidor de desarrollo:

   npm run dev

Implementación de Docker

1. Construya y ejecute usando docker-compose:

   docker-compose up --build

Implementación de Coolify

1. En tu panel de Coolify, crea un nuevo servicio

2. Seleccione "Implementar desde la fuente"

3. 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