Servidor Whoop MCP

Licencia del paquete Python: MIT Python 3.12

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Whoop. Permite que los modelos de lenguaje consulten datos de ciclos, recuperación, esfuerzo y entrenamiento desde la API de Whoop.

Herramientas disponibles

El servidor expone las siguientes herramientas:

Consultas de ciclo

• get_cycle_collection(start_date: str, end_date: str) : Obtener datos del ciclo para un rango de fechas específico

• get_latest_cycle() : Obtener los datos del ciclo más recientes

Recuperación y tensión

• 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) : obtiene datos de tensión para un rango de fechas específico

• get_average_strain(days: int = 7) : Calcula la deformación 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).

Related MCP server: coros-mcp

Uso

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

Claude para escritorio

Actualice su 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 API HTTP

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

./run_whoop_server.sh

Consultas de ejemplo

Una vez conectado, puedes hacerle preguntas a Claude como:

• "¿Cuál es mi puntuación de recuperación para hoy?"

• "Muéstrame mis datos de tensión de la última semana"

• "¿Cuál es mi tensión promedio durante los últimos 7 días?"

• "Obtener los datos de mi último ciclo"

Manejo de errores

El servidor proporciona mensajes de error legibles por humanos para problemas comunes:

• Formatos de fecha no válidos

• Errores de autenticación de API

• Problemas de conectividad de red

• Credenciales faltantes o no vá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: consulte el archivo de LICENCIA para obtener más detalles.