Argentina BOPBA - MCP Server

MCP Server para buscar y extraer legislación provincial del Boletín Oficial de la Provincia de Buenos Aires (BOPBA). Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial provincial para realizar búsquedas en tiempo real y extraer el articulado completo con fidelidad jurídica sin alucinaciones.

🚀 Características Principales

• Buscador Avanzado (buscar_boletin): Búsquedas avanzadas en tiempo real por texto libre, secciones, número de boletín y rango de fechas en toda la base histórica del BOPBA.
• Extracción de PDFs (descargar_seccion): Descarga y extrae el texto completo de secciones específicas desde los PDFs oficiales firmados digitalmente.
• Última Edición (obtener_ultimo_boletin): Recupera automáticamente el último boletín publicado con todos sus metadatos.
• Búsqueda Semántica (buscar_por_semantica): Búsqueda inteligente con expansión de términos y sinónimos para encontrar publicaciones relacionadas.
• Análisis de Vigencia (verificar_vigencia): Verifica la disponibilidad de publicaciones y detecta modificaciones o actualizaciones.
• Detección de Plazos (detector_plazos_edictos): Identifica automáticamente plazos y fechas límite en edictos judiciales y administrativos.
• Certificación Forense (generar_certificacion_forense): Genera certificados digitales con hash SHA-256 para garantizar la inalterabilidad del contenido extraído.
• Cálculo de Tasas (calcular_tarifa): Calcula automáticamente las tasas de publicación según el tipo de aviso y características.
• Directorio de Agencias (listar_agencias): Acceso al directorio oficial de agencias del BOPBA para contacto y consulta.
• 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: bopba-mcp
   • Type: command
   • Command: node
   • Args: D:/MCP/Legales/03-bopba-mcp/Argentina-Bopba-MCP/build/index.js
   • Env: NODE_TLS_REJECT_UNAUTHORIZED=0

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": {
    "bopba-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/03-bopba-mcp/Argentina-Bopba-MCP/build/index.js"],
      "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 de los sitios gubernamentales argentinos.

3. Antigravity / Codex

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

{
  "mcpServers": {
    "bopba-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/03-bopba-mcp/Argentina-Bopba-MCP/build/index.js"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

💻 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/bopba-mcp.git
   cd bopba-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/bopba-mcp/build/index.js
   • Claude Desktop Config:

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

⚖️ Catálogo de Herramientas Disponibles (Tools)

El servidor expone 15 herramientas especializadas diseñadas para interactuar con el Boletín Oficial de la Provincia de Buenos Aires:

| Herramienta | Descripción Técnica | Parámetros Clave | |---|---|---| | buscar_boletin | Búsqueda avanzada de boletines con filtros múltiples | words, date_gteq, date_lteq, section, sort, page | | descargar_seccion | Descarga y extrae texto de PDFs de secciones específicas | id | | obtener_ultimo_boletin | Recupera el último boletín publicado con sus secciones | (Ninguno) | | ver_seccion | Vista previa de secciones específicas con metadatos | id | | listar_ediciones_anteriores | Lista ediciones históricas con paginación | date_gteq, date_lteq, page | | buscar_por_semantica | Búsqueda semántica con expansión de términos equivalentes | concepto, terminos_equivalentes, fecha_desde, fecha_hasta, seccion | | verificar_vigencia | Verifica disponibilidad y modificaciones de publicaciones | id | | relacionar_publicaciones | Busca publicaciones relacionadas por tema o criterio | id, palabras_clave, fecha_desde, fecha_hasta | | detector_plazos_edictos | Detecta plazos y fechas límite en edictos (especialmente sucesorios) | id, texto_manual | | exportar_seccion | Exporta secciones a Markdown con frontmatter YAML | id, incluir_texto | | generar_certificacion_forense | Genera certificación con hash SHA-256 para inalterabilidad | id | | calcular_tarifa | Calcula aproximación de tasas de publicación (usa web para valores exactos) | categoria, texto, dias, urgencia, actualizar | | actualizar_tasas | Actualiza tasas desde PDF oficial del BOPBA | forzar | | listar_agencias | Directorio de agencias del BOPBA para contacto | (Ninguno) | | alcance_fuente | Información sobre la fuente legal, limitaciones y disclaimer | (Ninguno) |

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