remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Utilizes environment variables for storing Whoop credentials, with support for .env configuration files.
Supports deployment on macOS through Claude for Desktop configuration, with specific paths for the macOS environment.
Built as a Python package (3.12) that implements the MCP server functionality to connect with the Whoop API.
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íficoget_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íficoget_strain_data(start_date: str, end_date: str)
: obtiene datos de tensión para un rango de fechas específicoget_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 usuariocheck_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á 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:
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:
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
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
This server cannot be installed
Un servidor de protocolo de contexto de modelo que proporciona modelos de lenguaje con acceso a datos personales de fitness de Whoop, lo que permite realizar consultas sobre información de ciclos, recuperación, esfuerzo y entrenamiento desde la API de Whoop.