README.md•5.46 kB
# 🏕️ 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**