🏕️ TreePod Financial MCP Agent

Agente inteligente que responde consultas financieras sobre TreePod Glamping directamente dentro de Claude Desktop usando el protocolo MCP (Model Context Protocol).

🚀 Instalación Rápida

cd /Users/janetsepulvedacorrea/Desktop/AGENTES/treepod-financial-mcp
chmod +x install.sh
./install.sh

📋 Requisitos

Node.js v18 o superior
npm
Claude Desktop instalado
macOS (configuración específica para esta ruta)

🛠️ Herramientas Disponibles

El agente incluye 8 herramientas financieras especializadas:

💰 `analyze_finances`

Analiza las finanzas actuales con métricas clave, metas y recomendaciones.

Ejemplo de uso: "Analiza las finanzas de TreePod"

💵 `calculate_tariff`

Calcula tarifas para reservas según temporada, personas y canal de venta.

Parámetros:

checkin_date: Fecha de entrada (YYYY-MM-DD)
checkout_date: Fecha de salida (YYYY-MM-DD)
guests: Número de huéspedes (1-4)
channel: Canal de venta (directo, airbnb, booking, whatsapp)

Ejemplo de uso: "Calcula una tarifa para 2 personas del 20 al 25 de enero por Airbnb"

🏠 `check_occupancy`

Verifica estado de ocupación actual y futura de los domos.

Ejemplo de uso: "¿Cuál es la ocupación actual?"

🔍 `compare_competition`

Compara precios y servicios con la competencia local.

Ejemplo de uso: "Compara nuestros precios con la competencia"

📊 `generate_report`

Genera reportes ejecutivos del negocio.

Tipos de reporte:

monthly: Reporte mensual completo
financial: Reporte financiero específico
occupancy: Reporte de ocupación
competition: Reporte competitivo

Ejemplo de uso: "Genera un reporte mensual"

🎯 `get_business_status`

Muestra el estado general actual del negocio con alertas y KPIs.

Ejemplo de uso: "¿Cuál es el estado del negocio?"

📈 `predict_revenue`

Predice ingresos futuros basado en datos históricos y tendencias.

Períodos:

next_week: Próxima semana
next_month: Próximo mes
next_quarter: Próximo trimestre

Ejemplo de uso: "Predice los ingresos del próximo mes"

💡 `optimize_pricing`

Sugiere optimizaciones de precios basado en competencia y ocupación.

Estrategias:

maximize_revenue: Maximizar ingresos
maximize_occupancy: Maximizar ocupación
competitive: Estrategia competitiva

Ejemplo de uso: "Optimiza los precios para maximizar ingresos"

🔧 Configuración Manual

Si la instalación automática falla, sigue estos pasos:

1. Instalar Dependencias

cd /Users/janetsepulvedacorrea/Desktop/AGENTES/treepod-financial-mcp
npm install

2. Configurar Claude Desktop

Edita el archivo: ~/Library/Application Support/Claude/claude_desktop_config.json

Agrega esta configuración (mantén las existentes):

{
  "mcpServers": {
    "treepod-financial": {
      "command": "node",
      "args": ["/Users/janetsepulvedacorrea/Desktop/AGENTES/treepod-financial-mcp/index.js"],
      "env": {}
    }
  }
}

3. Reiniciar Claude Desktop

killall Claude
# Luego abre Claude Desktop manualmente

🔍 Diagnóstico

Para verificar que todo funciona correctamente:

chmod +x diagnose.sh
./diagnose.sh

📂 Estructura del Proyecto

treepod-financial-mcp/
├── index.js           # Punto de entrada
├── server.js          # Servidor MCP con todas las herramientas
├── package.json       # Configuración del proyecto
├── install.sh         # Instalador completo
├── setup.sh           # Configuración del proyecto
├── configure-claude.sh # Configuración de Claude Desktop
├── diagnose.sh        # Script de diagnóstico
└── README.md          # Esta documentación

💬 Ejemplos de Uso en Claude Desktop

Una vez configurado, puedes hacer preguntas naturales como:

"¿Cómo están las finanzas de TreePod este mes?"
"Calcula el precio para una familia de 4 personas por 3 noches"
"¿Cuántos domos están ocupados hoy?"
"Genera un reporte ejecutivo del negocio"
"¿Cuáles son nuestros ingresos proyectados?"
"Optimiza los precios para la próxima semana"

📊 Fuentes de Datos

El agente integra datos de:

Datos financieros: /AGENTES/TreePod-Sistema/app-treepod/data/sample-data.json
Estado del negocio: /AGENTES/shared-data/inter-agent-bus.json
Análisis competitivo: /AGENTES/treepod-competitive-agent/reports/

🔧 Solución de Problemas

❌ "MCP server not found"

Verifica que Claude Desktop esté completamente cerrado
Ejecuta killall Claude
Vuelve a abrir Claude Desktop

❌ "Module not found"

rm -rf node_modules package-lock.json
npm install

❌ "Permission denied"

chmod +x *.sh
chmod +x index.js
chmod +x server.js

📋 Verificar logs

Los logs de Claude Desktop están en:

~/Library/Logs/Claude/

🆕 Actualizaciones

Para actualizar el agente:

git pull origin main  # Si está en un repo
./install.sh         # Reinstalar

📞 Soporte

Si encuentras problemas:

Ejecuta ./diagnose.sh y comparte la salida
Verifica los logs de Claude Desktop
Asegúrate que todos los archivos de datos existan

📄 Licencia

MIT - Libre para uso en TreePod Glamping

🏕️ TreePod Glamping - Tecnología al servicio de la experiencia