arvo-mcp
Servidor MCP de entrenador de ejercicios con IA. Accede a datos de entrenamiento, historial de ejercicios, récords personales y progreso corporal a través de Claude Desktop.
Documentación
Servidor MCP de Arvo - Rastreador de Fitness y Entrenamientos para Claude
Servidor MCP de seguimiento de fitness - Registra sesiones de gimnasio, realiza un seguimiento de tus marcas personales (PRs), analiza el progreso corporal y gestiona divisiones de entrenamiento a través de Claude Desktop, Cursor y otros clientes MCP.
arvo-mcp es un servidor de Protocolo de Contexto de Modelo (MCP) que conecta tu asistente de IA con Arvo, un entrenador de fitness impulsado por IA. Accede a tu historial de entrenamientos, marcas personales, composición corporal y planes de entrenamiento directamente desde Claude Desktop, Cursor o cualquier cliente compatible con MCP.
Perfecto para entusiastas del fitness que quieren:
- 🏋️ Preguntar "¿Cuál es mi entrenamiento de hoy?" y obtener tu plan de entrenamiento personalizado
- 📊 Realizar un seguimiento del progreso en el gimnasio con información impulsada por IA
- 💪 Monitorear PRs, volumen y distribución de grupos musculares
- 📈 Analizar tendencias de composición corporal a lo largo del tiempo
Características
- 29 herramientas de fitness - Perfil, entrenamientos, divisiones, PRs, progreso corporal y más
- Acceso de lectura y escritura - Visualiza tus datos y realiza cambios mediante conversación natural
- Autenticación segura con clave API - Tus datos permanecen privados
- Funciona con cualquier cliente MCP - Claude Desktop, Cursor, Windsurf y más
Inicio Rápido
1. Obtén tu clave API
- Regístrate o inicia sesión en arvo.guru
- Ve a Configuración → Claves API
- Haz clic en Crear clave y copia tu clave API
2. Configura tu cliente MCP
Claude Desktop
Agrega a tu claude_desktop_config.json:
{
"mcpServers": {
"arvo": {
"command": "npx",
"args": ["-y", "arvo-mcp"],
"env": {
"ARVO_API_KEY": "arvo_your_api_key_here"
}
}
}
}
Ubicación del archivo de configuración:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
Agrega a tu configuración MCP de Cursor:
{
"mcpServers": {
"arvo": {
"command": "npx",
"args": ["-y", "arvo-mcp"],
"env": {
"ARVO_API_KEY": "arvo_your_api_key_here"
}
}
}
}
3. ¡Comienza a chatear!
Después de reiniciar tu cliente de IA, intenta preguntar:
- "¿Cuál es mi entrenamiento para hoy?"
- "Muéstrame mis PRs recientes"
- "¿Cómo va mi progreso en press de banca?"
- "¿Qué grupos musculares estoy entrenando esta semana?"
Herramientas Disponibles
Herramientas de Solo Lectura (19)
| Herramienta | Descripción |
|---|---|
get_user_profile | Obtén tu perfil de fitness, nivel de experiencia y preferencias |
get_active_split | Obtén tu división de entrenamiento y horario actuales |
get_recent_workouts | Visualiza tus entrenamientos completados más recientes |
get_workout_for_day | Obtén el entrenamiento para cualquier día del ciclo |
get_workout_stats | Obtén estadísticas de entrenamiento agregadas |
get_active_insights | Visualiza información de entrenamiento generada por IA |
get_personal_records | Consulta tus PRs para cada ejercicio |
get_exercise_progress | Realiza un seguimiento de la progresión de ejercicios específicos |
get_exercise_video | Obtén videos de demostración para ejercicios |
get_volume_by_muscle | Visualiza la distribución de volumen por grupo muscular |
get_coach_info | Obtén la información de tu entrenador |
get_coach_notes | Visualiza las notas de tu entrenador |
get_approach_details | Conoce tu metodología de entrenamiento |
get_body_progress | Realiza un seguimiento de los cambios en la composición corporal |
get_cycle_history | Visualiza el historial de ciclos de entrenamiento |
get_booking_info | Consulta tus reservas de sesiones de entrenamiento personal |
get_ai_memory | Accede al contexto de IA guardado sobre ti |
get_caloric_history | Visualiza el historial de fases calóricas |
get_approach_history | Consulta los cambios de metodología a lo largo del tiempo |
Herramientas de Escritura (10)
| Herramienta | Descripción |
|---|---|
save_memory | Guarda notas para que la IA las recuerde |
update_caloric_phase | Cambia tu fase actual de volumen/definición/mantenimiento |
update_weak_points | Actualiza los grupos musculares prioritarios |
report_physical_issue | Registra dolor o lesiones |
skip_exercise | Omite un ejercicio en el entrenamiento de hoy |
generate_workout | Genera un nuevo entrenamiento |
update_equipment | Actualiza tu equipo disponible |
add_exercise | Agrega un ejercicio a tu entrenamiento |
swap_exercise | Solicita alternativas de ejercicios |
apply_swap | Aplica un cambio de ejercicio |
Seguridad
- Tu clave API se almacena localmente y nunca se envía a terceros
- Toda la comunicación utiliza HTTPS
- Las claves API se pueden revocar en cualquier momento desde tu panel de Arvo
- Cada clave tiene alcances configurables (lectura/escritura)
Para informes de vulnerabilidades de seguridad, consulta SECURITY.md.
Preguntas Frecuentes
¿Qué es el Protocolo de Contexto de Modelo (MCP)?
MCP es un protocolo abierto que permite a asistentes de IA como Claude acceder de forma segura a fuentes de datos externas. arvo-mcp permite que Claude acceda a tus datos de entrenamiento, historial de ejercicios y métricas de fitness mediante conversación natural.
¿Cómo se protegen mis datos?
- Las claves API se cifran con SHA-256 (nunca se almacenan en texto plano)
- Toda la comunicación utiliza cifrado HTTPS
- Las claves se pueden revocar al instante desde tu panel
- Permisos con alcance (solo lectura o lectura-escritura)
- Tu clave API se almacena solo en tu máquina local
¿Puedo usarlo sin conexión?
No, arvo-mcp requiere una conexión a internet para comunicarse con los servidores de arvo.guru. El servidor MCP se ejecuta localmente, pero obtiene tus datos desde la nube.
¿Qué clientes de IA son compatibles?
Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP. El servidor utiliza el transporte estándar stdio de MCP, lo que lo hace compatible con cualquier cliente que admita el protocolo.
¿Cómo informo problemas de seguridad?
Envía un correo a security@arvo.guru con los detalles. Consulta SECURITY.md para conocer nuestra política de seguridad completa y el proceso de divulgación responsable.
¿A qué datos puede acceder la IA?
La IA puede acceder a tus planes de entrenamiento, historial de ejercicios, marcas personales, seguimiento de composición corporal y notas del entrenador. Las herramientas de escritura permiten guardar recuerdos, actualizar preferencias y modificar entrenamientos. Tú controlas el acceso mediante los alcances de la clave API.
¿Funciona sin una cuenta de Arvo?
No, necesitas una cuenta de Arvo para generar una clave API. Regístrate gratis en arvo.guru.
¿Cómo actualizo a una nueva versión?
Si usas npx -y arvo-mcp, obtiene automáticamente la última versión. Para instalaciones globales, ejecuta npm update -g arvo-mcp.
Variables de Entorno
| Variable | Requerida | Descripción |
|---|---|---|
ARVO_API_KEY | Sí | Tu clave API de Arvo |
ARVO_BASE_URL | No | URL base de la API (predeterminada: https://arvo.guru) |
Requisitos
- Node.js 18+
- Una cuenta de Arvo (regístrate gratis)
Enlaces
- Arvo - Entrenador Personal de IA: arvo.guru
- Documentación: arvo.guru/docs
- Reportar Problemas: GitHub Issues
- Protocolo MCP: modelcontextprotocol.io
- Paquete npm: npmjs.com/package/arvo-mcp
Relacionados
¿Buscas seguimiento de fitness con IA? Consulta:
- Arvo - Entrenador de fitness con IA que crea programas de entrenamiento personalizados
- Protocolo de Contexto de Modelo - El protocolo abierto que impulsa esta integración
Licencia
MIT - consulta LICENSE para más detalles.
🏋️ Realiza un seguimiento de tus entrenamientos de gimnasio con IA
Comienza con Arvo →