Whoop

Servidor MCP Whoop

Licença do Pacote Python: MIT Python 3.12

Um servidor Model Context Protocol (MCP) que fornece acesso à API Whoop. Ele permite que modelos de linguagem consultem dados de ciclos, recuperação, strain e treinos da API Whoop.

Ferramentas Disponíveis

O servidor expõe as seguintes ferramentas:

Consultas de Ciclo

• get_cycle_collection(start_date: str, end_date: str): Obter dados de ciclo para um intervalo de datas específico
• get_latest_cycle(): Obter os dados do ciclo mais recente

Recuperação e Strain

• get_recovery_data(start_date: str, end_date: str): Obter dados de recuperação para um intervalo de datas específico
• get_strain_data(start_date: str, end_date: str): Obter dados de strain para um intervalo de datas específico
• get_average_strain(days: int = 7): Calcular o strain médio ao longo de um número especificado de dias

Perfil e Autenticação

• get_profile(): Obter informações do perfil do usuário
• check_auth_status(): Verificar o status de autenticação com a API Whoop

As datas devem ser fornecidas no formato ISO (AAAA-MM-DD).

Uso

Você precisará de credenciais Whoop para usar este servidor. O servidor usa autenticação por e-mail/senha com a API Whoop.

Claude para Desktop

Atualize seu claude_desktop_config.json (localizado em ~/Library/Application\ Support/Claude/claude_desktop_config.json no macOS e %APPDATA%/Claude/claude_desktop_config.json no Windows) para incluir o seguinte:

{
    "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

O projeto também inclui um servidor de API HTTP que expõe a mesma funcionalidade por meio de endpoints HTTP. Para executá-lo:

./run_whoop_server.sh

Exemplos de Consultas

Uma vez conectado, você pode fazer perguntas ao Claude como:

• "Qual é a minha pontuação de recuperação hoje?"
• "Mostre-me meus dados de strain da última semana"
• "Qual é o meu strain médio nos últimos 7 dias?"
• "Obtenha meus dados do ciclo mais recente"

Tratamento de Erros

O servidor fornece mensagens de erro legíveis para problemas comuns:

• Formatos de data inválidos
• Erros de autenticação da API
• Problemas de conectividade de rede
• Credenciais ausentes ou inválidas

Estrutura do Projeto

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

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.