Bora

NPM Version TypeScript MCP

MCP Server para buscar y extraer avisos, decretos y resoluciones del Boletín Oficial de la República Argentina (boletinoficial.gob.ar). Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial para realizar búsquedas en tiempo real y extraer el articulado completo con fidelidad jurídica sin alucinaciones.

---

🚀 Características Principales

• Buscador Avanzado Integrado (buscar_avisos): Búsquedas avanzadas multiplataforma en tiempo real por texto libre, secciones, número o año de norma, y rango de fechas en toda la base histórica de avisos.
• Fidelidad Verbatim Absoluta (obtener_detalle_aviso): Recupera el cuerpo oficial de cualquier ley o aviso, removiendo scripts y estilos dinámicos pero conservando de forma exacta la alineación de párrafos y saltos de línea con fidelidad jurídica total.
• Scraping Concurrente e Índices Diarios (obtener_sumario_del_dia): Agrega en paralelo, mediante concurrencia asíncrona optimizada, los sumarios diarios de las 4 secciones regulatorias oficiales para obtener una visión unificada agrupada por rubro y tema.
• Captura Dinámica de Portada (obtener_portada): Scrapea la página de inicio del Boletín Oficial, detecta la fecha activa en Argentina, extrae carruseles informativos gubernamentales y construye enlaces directos de descarga para los PDFs firmados digitalmente.
• Buscadores Temáticos Optimizados:
  • Constitución de Sociedades Comerciales (Sección Segunda).
  • Licitaciones Públicas y Compras del Estado (Sección Tercera).
• Resiliencia Criptográfica: Configurado con agentes HTTPS tolerantes a fallos criptográficos para saltear bloqueos por expiración de cadenas de confianza SSL en los portales gubernamentales.

---

🛠️ Instalación y Configuración Rápida

Para utilizar este servidor MCP de forma inmediata, necesitas tener instalado Node.js (versión 18 o superior).

1. Cursor IDE / Windsurf

Tanto Cursor como Windsurf admiten servidores MCP de forma nativa a través del protocolo standard I/O (stdio):

1. Abre la configuración (Settings) de tu entorno de desarrollo y busca la sección MCP.
2. Haz clic en + Add New MCP Server.
3. Completa los campos requeridos:
   • Name: bora-mcp
   • Type: command
   • Command: npx -y bora-mcp (o la ruta al paquete local publicado).

2. Claude Desktop

1. Abre tu archivo de configuración de Claude Desktop. En Windows, se localiza normalmente en: C:\Users\<TuUsuario>\AppData\Roaming\Claude\claude_desktop_config.json
2. Agrega el servidor dentro de la clave mcpServers:

{
  "mcpServers": {
    "bora-mcp": {
      "command": "npx",
      "args": ["-y", "bora-mcp"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

[!IMPORTANT] La variable de entorno "NODE_TLS_REJECT_UNAUTHORIZED": "0" es fundamental para saltear problemas periódicos con los certificados SSL vencidos o mal configurados del sitio del Boletín Oficial de la Nación.

3. Antigravity / Codex

Configura el servidor dentro del archivo de configuración global mcp_config.json:

{
  "mcpServers": {
    "bora-mcp": {
      "command": "npx",
      "args": ["-y", "bora-mcp"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

4. Claude Web (Claude.ai Custom Connectors)

[!TIP] ¿Estás utilizando Claude Web (Claude.ai)? ¡No necesitas instalar Node.js ni ejecutar nada localmente! Puedes conectar este servidor de forma 100% remota y serverless utilizando nuestro endpoint oficial.

Para conectarlo en segundos, solo necesitas ingresar estos dos datos:

1. Ve a la sección de configuración de conectores personalizados en Claude.ai Connectors.
2. Haz clic en Add Connector o Connect Server.
3. Completa los campos requeridos:
   • Name: bora-mcp
   • URL: https://bora-mcp.vercel.app/api/mcp/sse
4. Guarda la configuración. ¡Listo! Claude Web ahora se comunicará en tiempo real con el portal oficial del BORA de manera serverless.

---

💡 ¿Necesitas ejemplos de prompts para aprender a promptear a la IA y usar correctamente este MCP? Consulta nuestra biblioteca interactiva con prompts óptimos y flujos de trabajo combinados en: bora-mcp.vercel.app/prompts

---

5. Antigravity / Codex (Integración SSE Remota)

Para configurar la versión serverless de alta disponibilidad directamente en Antigravity u otros clientes compatibles con MCP SSE: Agrega la siguiente configuración en tu archivo mcp_config.json:

{
  "mcpServers": {
    "bora-mcp-sse": {
      "type": "sse",
      "url": "https://bora-mcp.vercel.app/api/mcp/sse"
    }
  }
}

💡 Ventaja de la integración SSE Remota: No requiere ejecutar comandos locales (npx), instalar Node.js ni consumir recursos en tu máquina, ya que se ejecuta de manera 100% serverless en Vercel Edge con caching de base de datos.

---

💻 Instalación Manual (Para Desarrolladores)

Si deseas descargar el código fuente, auditar la lógica de scraping o contribuir al desarrollo local:

1. Clona el repositorio oficial:

   git clone https://github.com/voftec/bora-mcp.git
   cd bora-mcp
   

2. Instala las dependencias de desarrollo y producción:

   npm install
   

3. Compila el código TypeScript a JavaScript de distribución ESM:

   npm run build
   

4. Configura tu cliente MCP local apuntando directamente a la build construida:
   • Cursor Command: node D:/ruta-a-tu-carpeta/bora-mcp/build/index.js
   • Claude Desktop Config:

     "bora-mcp": {
       "command": "node",
       "args": ["D:/ruta-a-tu-carpeta/bora-mcp/build/index.js"],
       "env": {
         "NODE_TLS_REJECT_UNAUTHORIZED": "0"
       }
     }
     

---

⚖️ Catálogo de Herramientas Disponibles (Tools)

El servidor expone 14 herramientas especializadas diseñadas para emular con precisión metodológica a un investigador jurídico experto:

Herramienta	Descripción Técnica	Parámetros Clave
buscar_avisos	Búsqueda avanzada multisección de edictos y leyes.	criterio, seccion, fechaDesde, fechaHasta, nroNorma, pagina
obtener_detalle_aviso	Extrae el cuerpo verbatim íntegro de un aviso o ley.	seccion, idAviso, fecha
obtener_sumario_seccion	Recupera el sumario completo de una sección del día agrupado por rubros (con parser NIC Argentina en Sección 4).	seccion, fecha
obtener_enlace_pdf	Genera la ruta directa oficial para descarga del PDF firmado.	seccion, idAviso, fecha
buscar_nuevas_sociedades	Buscador optimizado para constituciones de firmas comerciales (Sección 2).	fechaDesde, fechaHasta, pagina
buscar_licitaciones_publicas	Buscador especializado de contrataciones y pliegos públicos (Sección 3).	criterio, fechaDesde, fechaHasta, pagina
alcance_fuente	Información sobre la fuente legal, limitaciones técnicas y disclaimer de uso.	(Ninguno)
obtener_portada	Scrapea la portada de hoy, destaques y descargas de PDFs de edición completa.	(Ninguno)
obtener_sumario_del_dia	Agregador altamente concurrente de sumarios de las 4 secciones unificadas.	fecha
buscar_sociedades_por_tipo	Buscador en la Segunda Sección con filtros por tipo de acto y tipo societario.	tipoActo, tipoSocietario, fechaDesde, fechaHasta, pagina
buscar_norma_primera_seccion	Búsqueda directa de normas oficiales (decretos, resoluciones, leyes) por N° y/o año.	nroNorma, anioNorma, criterio, fechaDesde, fechaHasta, pagina
buscar_avisos_judiciales	Buscador especializado en edictos, sucesiones e inhibiciones (Sección Segunda).	criterio, fechaDesde, fechaHasta, pagina
buscar_marcas_patentes	Buscador en la Cuarta Sección con ventana móvil automática de 15 días.	criterio, fechaDesde, fechaHasta, pagina
rastrear_vigencia_norma	Rastreo cronológico de referencias de una norma para analizar su vigencia histórica.	nroNorma, anioNorma, fechaDesde, fechaHasta

---

📝 Licencia

Este proyecto se distribuye de forma abierta y transparente bajo los términos de la Licencia MIT. Consulta el archivo LICENSE para más detalles.