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.

npm version License: MIT 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

  1. Regístrate o inicia sesión en arvo.guru
  2. Ve a ConfiguraciónClaves API
  3. 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)

HerramientaDescripción
get_user_profileObtén tu perfil de fitness, nivel de experiencia y preferencias
get_active_splitObtén tu división de entrenamiento y horario actuales
get_recent_workoutsVisualiza tus entrenamientos completados más recientes
get_workout_for_dayObtén el entrenamiento para cualquier día del ciclo
get_workout_statsObtén estadísticas de entrenamiento agregadas
get_active_insightsVisualiza información de entrenamiento generada por IA
get_personal_recordsConsulta tus PRs para cada ejercicio
get_exercise_progressRealiza un seguimiento de la progresión de ejercicios específicos
get_exercise_videoObtén videos de demostración para ejercicios
get_volume_by_muscleVisualiza la distribución de volumen por grupo muscular
get_coach_infoObtén la información de tu entrenador
get_coach_notesVisualiza las notas de tu entrenador
get_approach_detailsConoce tu metodología de entrenamiento
get_body_progressRealiza un seguimiento de los cambios en la composición corporal
get_cycle_historyVisualiza el historial de ciclos de entrenamiento
get_booking_infoConsulta tus reservas de sesiones de entrenamiento personal
get_ai_memoryAccede al contexto de IA guardado sobre ti
get_caloric_historyVisualiza el historial de fases calóricas
get_approach_historyConsulta los cambios de metodología a lo largo del tiempo

Herramientas de Escritura (10)

HerramientaDescripción
save_memoryGuarda notas para que la IA las recuerde
update_caloric_phaseCambia tu fase actual de volumen/definición/mantenimiento
update_weak_pointsActualiza los grupos musculares prioritarios
report_physical_issueRegistra dolor o lesiones
skip_exerciseOmite un ejercicio en el entrenamiento de hoy
generate_workoutGenera un nuevo entrenamiento
update_equipmentActualiza tu equipo disponible
add_exerciseAgrega un ejercicio a tu entrenamiento
swap_exerciseSolicita alternativas de ejercicios
apply_swapAplica 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

VariableRequeridaDescripción
ARVO_API_KEYTu clave API de Arvo
ARVO_BASE_URLNoURL base de la API (predeterminada: https://arvo.guru)

Requisitos

Enlaces

Relacionados

¿Buscas seguimiento de fitness con IA? Consulta:

Licencia

MIT - consulta LICENSE para más detalles.


🏋️ Realiza un seguimiento de tus entrenamientos de gimnasio con IA
Comienza con Arvo →