TreePod Financial MCP Agent

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

An intelligent agent that responds to financial queries about TreePod Glamping directly within Claude Desktop using MCP protocol, providing tools for tariff calculation, occupancy checking, financial analysis, and business reporting.

Related MCP Servers

MCP Reasoner
parmarjh
A
security
A
license
A
quality
A systematic reasoning MCP server for Claude Desktop, featuring Beam Search and Monte Carlo Tree Search to facilitate complex problem-solving and decision-making processes.
Last updated -
1
11
TypeScript
MIT License
FreeAgent MCP Server
markpitt
A
security
A
license
A
quality
A Claude MCP server that allows Claude to interact with your FreeAgent account to track time, manage timers, and handle timeslip operations.
Last updated -
7
1
JavaScript
MIT License
mcp-server-tree-sitter
wrale
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides code analysis capabilities using tree-sitter, designed to give Claude intelligent access to codebases with appropriate context management.
Last updated -
26
122
Python
MIT License
Trading Simulator MCP Server
recallnet
A
security
F
license
A
quality
An MCP server that enables AI models like Claude to interact with the Trading Simulator API for checking balances, viewing prices, and executing trades with automatic chain detection.
Last updated -
15
TypeScript

View all related MCP servers

TreePod Financial MCP Agent