FONASA MLE Open Data & MCP Server

Este proyecto tiene como objetivo democratizar el acceso al catálogo de exámenes de la Modalidad Libre Elección (MLE) de FONASA en Chile.

Proporcionamos los datos limpios en formato JSON y un servidor MCP (Model Context Protocol) para que agentes de IA y desarrolladores puedan consultar códigos, descripciones y precios oficiales de forma sencilla.

✨ Características

• Normalización Inteligente: Los códigos se normalizan automáticamente a 7 dígitos (Grupo + Subgrupo + Item).
• Seguridad: Parser de XML protegido contra XXE y validación de tipos con Zod.
• Búsqueda Robusta: Soporta búsquedas por nombre (case-insensitive) y por código (exacto o parcial).
• Multi-año: Soporte para catálogos 2025 y 2026.
• Precios Precisos: Conversión de moneda desde Excel ajustada para el formato chileno (puntos de miles vs decimales).

🚀 Instalación y Uso

Uso rápido con npx

Puedes ejecutar el servidor directamente sin instalarlo permanentemente:

npx @mariohealthbits/fonasa-mle-open

Configuración en Claude Desktop

Para usar este catálogo directamente en Claude, añade lo siguiente a tu archivo de configuración (claude_desktop_config.json):

{
  "mcpServers": {
    "fonasa-mle": {
      "command": "npx",
      "args": ["-y", "@mariohealthbits/fonasa-mle-open"]
    }
  }
}

🧪 Desarrollo Local

Si quieres contribuir o ejecutar pruebas localmente:

# Instalar dependencias
pnpm install

# Compilar el servidor
pnpm build

# Ejecutar el cliente de prueba funcional
node --import tsx tests/test-client.ts

🛠 Tech Stack

• TypeScript: Servidor MCP robusto.
• Python: Scripts de extracción quirúrgica desde XLSX oficiales.
• LXML: Procesamiento eficiente de archivos XML de Excel.

📁 Estructura

• data/: Catálogos anuales (mle-2025.json, mle-2026.json).
• src/: Lógica del servidor MCP.
• scripts/: Herramientas de extracción y normalización.

📅 Roadmap

• [x] Generar JSON para MLE 2025 y 2026.
• [x] Implementar servidor MCP básico (search y detail).
• [ ] Publicar en Smithery.ai para mayor visibilidad.
• [ ] GitHub Action para actualización automática en 2027.

Impulsado por la comunidad y el equipo de Examya.