Copilto Financiero Banorte

Inspiration

Durante el hackathon, observamos que las PyMEs en México dedican más de 3 horas semanales generando reportes financieros manualmente. Nos preguntamos: ¿Y si pudieras preguntarle a tus finanzas como le preguntas a un asesor? Así nació Copiloto Financiero Banorte.

What it does

Copiloto Financiero es un asistente inteligente que combina:

Chat conversacional con IA (Gemini 2.0 Flash) para análisis en lenguaje natural
Procesamiento automático de CSVs bancarios con insights instantáneos
Dashboard visual con KPIs accionables y badges inteligentes (Sano/Atención/Crítico)
6 herramientas financieras especializadas vía Model Context Protocol (MCP)

How we built it

Arquitectura

Frontend: React 18 + Vite + Tailwind CSS + shadcn/ui
Bridge Server: Node.js + Express conectando frontend, MCP y Gemini
MCP Server: Python + FastMCP con 6 tools financieras
AI: Google Gemini 2.0 Flash para procesamiento de lenguaje natural

Flujo de datos

Usuario sube CSV o hace pregunta
Frontend procesa datos localmente (Papaparse)
Bridge envía contexto financiero a Gemini
IA genera respuesta en español con análisis profundo
Dashboard actualiza KPIs y gráficos en tiempo real

Innovación clave

Implementamos el Model Context Protocol (MCP) de Anthropic para conectar herramientas financieras especializadas con Gemini, permitiendo:

Conversión de divisas en tiempo real
Análisis de flujo de caja
Proyecciones de retiro
Perfiles de riesgo

Challenges we ran into

1. Integración MCP + Gemini

Problema: MCP es protocolo nuevo (2024) con documentación limitada.
Solución: Implementamos bridge Node.js que maneja JSON-RPC sobre STDIO para comunicación bidireccional.

2. Procesamiento de CSV

Problema: Formatos inconsistentes en estados de cuenta mexicanos.
Solución: Parser inteligente que normaliza números ($, comas), detecta tipos (ingreso/gasto) y agrupa por mes/categoría automáticamente.

3. Context Management

Problema: Mantener contexto financiero relevante sin sobrecargar el prompt.
Solución: Sistema de resumen compacto que genera solo los KPIs y tendencias esenciales (menor a 500 tokens).

4. Orchestración de 3 servicios

Problema: Frontend + Bridge + MCP server corriendo simultáneamente.
Solución: Documentación detallada de setup y variables de entorno claramente definidas.

Accomplishments that we're proud of

Full-stack en 48h: Frontend + Bridge + MCP + IA completamente integrados
6 herramientas MCP funcionando en producción
Parser CSV robusto que maneja formatos bancarios mexicanos reales
Documentación profesional completa (README + Instalación + Arquitectura)
Demo funcional con análisis de datos reales en tiempo real

What we learned

MCP Protocol: Primera experiencia implementando el nuevo estándar de Anthropic para tool calling
Gemini 2.0 Flash: Capacidades de contexto largo y speed vs quality tradeoffs
Financial Domain: KPIs críticos para PyMEs (tasa de ahorro, relación gasto/ingreso, tendencias)
Real-time Data Viz: Recharts + React hooks para gráficos reactivos
Team Coordination: 4 personas, 48 horas, múltiples stacks tecnológicos