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

```bash
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
```bash
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):

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

### 3. Reiniciar Claude Desktop

```bash
killall Claude
# Luego abre Claude Desktop manualmente
```

## 🔍 Diagnóstico

Para verificar que todo funciona correctamente:

```bash
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"
```bash
rm -rf node_modules package-lock.json
npm install
```

### ❌ "Permission denied"
```bash
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:

```bash
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**