🏕️ 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:

1. Ejecuta ./diagnose.sh y comparte la salida
2. Verifica los logs de Claude Desktop
3. 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