Whoop

Accede a la API de Whoop para consultar datos de ciclos, recuperación, carga y entrenamiento.

GitHub
26
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Whoop

Licencia del paquete Python: MIT Python 3.12

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API de Whoop. Permite a los modelos de lenguaje consultar datos de ciclos, recuperación, esfuerzo y entrenamientos desde la API de Whoop.

Herramientas Disponibles

El servidor expone las siguientes herramientas:

Consultas de Ciclos

  • get_cycle_collection(start_date: str, end_date: str): Obtener datos de ciclos para un rango de fechas específico
  • get_latest_cycle(): Obtener los datos del ciclo más reciente

Recuperación y Esfuerzo

  • get_recovery_data(start_date: str, end_date: str): Obtener datos de recuperación para un rango de fechas específico
  • get_strain_data(start_date: str, end_date: str): Obtener datos de esfuerzo para un rango de fechas específico
  • get_average_strain(days: int = 7): Calcular el esfuerzo promedio durante un número específico de días

Perfil y Autenticación

  • get_profile(): Obtener información del perfil del usuario
  • check_auth_status(): Verificar el estado de autenticación con la API de Whoop

Las fechas deben proporcionarse en formato ISO (AAAA-MM-DD).

Uso

Necesitarás credenciales de Whoop para usar este servidor. El servidor utiliza autenticación por correo electrónico/contraseña con la API de Whoop.

Claude para Desktop

Actualiza tu claude_desktop_config.json (ubicado en ~/Library/Application\ Support/Claude/claude_desktop_config.json en macOS y %APPDATA%/Claude/claude_desktop_config.json en Windows) para incluir lo siguiente:

{
    "mcpServers": {
        "Whoop": {
            "command": "python",
            "args": ["/path/to/whoop/src/whoop_server.py"],
            "cwd": "/path/to/whoop",
            "env": {
                "WHOOP_EMAIL": "your.email@example.com",
                "WHOOP_PASSWORD": "your_password"
            }
        }
    }
}

Servidor de API HTTP

El proyecto también incluye un servidor de API HTTP que expone la misma funcionalidad a través de endpoints HTTP. Para ejecutarlo:

./run_whoop_server.sh

Consultas de Ejemplo

Una vez conectado, puedes hacer preguntas a Claude como:

  • "¿Cuál es mi puntuación de recuperación de hoy?"
  • "Muéstrame mis datos de esfuerzo de la semana pasada"
  • "¿Cuál es mi esfuerzo promedio en los últimos 7 días?"
  • "Obtén mis datos del ciclo más reciente"

Manejo de Errores

El servidor proporciona mensajes de error legibles para problemas comunes:

  • Formatos de fecha inválidos
  • Errores de autenticación de la API
  • Problemas de conectividad de red
  • Credenciales faltantes o inválidas

Estructura del Proyecto

whoop/
├── src/
│   ├── whoop_server.py      # MCP server implementation
│   └── whoop_http_server.py # HTTP API server implementation
├── config/
│   └── .env                 # Environment variables
├── requirements.txt         # Python dependencies
└── run_whoop_server.sh     # Script to run HTTP server

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.