arvo-mcp

Servidor MCP de coach de treino com IA. Acesse dados de treino, histórico de exercícios, recordes pessoais e progresso corporal através do Claude Desktop.

GitHub

Experimente este MCPPatrocinado

Documentação

Arvo MCP Server - Rastreador de Fitness e Treinos para Claude

Servidor MCP de rastreamento de fitness - Registre sessões de academia, acompanhe recordes pessoais (PRs), analise o progresso corporal e gerencie divisões de treino através do Claude Desktop, Cursor e outros clientes MCP.

arvo-mcp é um servidor Model Context Protocol (MCP) que conecta seu assistente de IA ao Arvo, um treinador de fitness com IA. Acesse seu histórico de treinos, recordes pessoais, composição corporal e planos de treino diretamente do Claude Desktop, Cursor ou qualquer cliente compatível com MCP.

Perfeito para entusiastas de fitness que desejam:

🏋️ Perguntar "Qual é o meu treino hoje?" e obter seu plano de treino personalizado
📊 Acompanhar o progresso na academia com insights gerados por IA
💪 Monitorar PRs, volume e distribuição por grupo muscular
📈 Analisar tendências de composição corporal ao longo do tempo

Recursos

29 ferramentas de fitness - Perfil, treinos, divisões, PRs, progresso corporal e mais
Acesso de leitura e escrita - Visualize seus dados e faça alterações por meio de conversa natural
Autenticação segura por chave de API - Seus dados permanecem privados
Funciona com qualquer cliente MCP - Claude Desktop, Cursor, Windsurf e mais

Início Rápido

1. Obtenha sua chave de API

Cadastre-se ou faça login em arvo.guru
Vá para Configurações → Chaves de API
Clique em Criar Chave e copie sua chave de API

2. Configure seu cliente MCP

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "arvo_your_api_key_here"
      }
    }
  }
}

Localização do arquivo de configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Adicione às configurações MCP do Cursor:

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "arvo_your_api_key_here"
      }
    }
  }
}

3. Comece a conversar!

Após reiniciar seu cliente de IA, tente perguntar:

"Qual é o meu treino de hoje?"
"Mostre-me meus PRs recentes"
"Como está meu progresso no supino?"
"Quais grupos musculares estou treinando esta semana?"

Ferramentas Disponíveis

Ferramentas Somente Leitura (19)

Ferramenta	Descrição
`get_user_profile`	Obtenha seu perfil de fitness, nível de experiência e preferências
`get_active_split`	Obtenha sua divisão de treino atual e cronograma
`get_recent_workouts`	Visualize seus treinos concluídos mais recentes
`get_workout_for_day`	Obtenha o treino para qualquer dia do ciclo
`get_workout_stats`	Obtenha estatísticas agregadas de treino
`get_active_insights`	Visualize insights de treino gerados por IA
`get_personal_records`	Veja seus PRs para cada exercício
`get_exercise_progress`	Acompanhe a progressão de exercícios específicos
`get_exercise_video`	Obtenha vídeos de demonstração para exercícios
`get_volume_by_muscle`	Visualize a distribuição de volume por grupo muscular
`get_coach_info`	Obtenha informações do seu treinador
`get_coach_notes`	Visualize anotações do seu treinador
`get_approach_details`	Conheça sua metodologia de treino
`get_body_progress`	Acompanhe mudanças na composição corporal
`get_cycle_history`	Visualize o histórico do ciclo de treino
`get_booking_info`	Veja seus agendamentos de sessões de PT
`get_ai_memory`	Acesse o contexto de IA salvo sobre você
`get_caloric_history`	Visualize o histórico de fases calóricas
`get_approach_history`	Veja mudanças na metodologia ao longo do tempo

Ferramentas de Escrita (10)

Ferramenta	Descrição
`save_memory`	Salve anotações para a IA lembrar
`update_caloric_phase`	Altere sua fase atual de bulking/cutting/manutenção
`update_weak_points`	Atualize grupos musculares prioritários
`report_physical_issue`	Registre dores ou lesões
`skip_exercise`	Pule um exercício no treino de hoje
`generate_workout`	Gere um novo treino
`update_equipment`	Atualize seus equipamentos disponíveis
`add_exercise`	Adicione um exercício ao seu treino
`swap_exercise`	Solicite alternativas de exercícios
`apply_swap`	Aplique uma troca de exercício

Segurança

Sua chave de API é armazenada localmente e nunca é enviada a terceiros
Toda a comunicação usa HTTPS
As chaves de API podem ser revogadas a qualquer momento no seu painel do Arvo
Cada chave possui escopos configuráveis (leitura/escrita)

Para relatórios de vulnerabilidades de segurança, consulte SECURITY.md.

FAQ

O que é o Model Context Protocol (MCP)?

MCP é um protocolo aberto que permite que assistentes de IA como o Claude acessem fontes de dados externas com segurança. O arvo-mcp permite que o Claude acesse seus dados de treino, histórico de treinamento e métricas de fitness por meio de conversa natural.

Como meus dados são protegidos?

As chaves de API são criptografadas com SHA-256 (nunca armazenadas em texto puro)
Toda a comunicação usa criptografia HTTPS
As chaves podem ser revogadas instantaneamente no seu painel
Permissões com escopo (somente leitura ou leitura/escrita)
Sua chave de API é armazenada apenas na sua máquina local

Posso usar isso offline?

Não, o arvo-mcp requer uma conexão com a internet para se comunicar com os servidores do arvo.guru. O servidor MCP é executado localmente, mas busca seus dados na nuvem.

Quais clientes de IA são suportados?

Claude Desktop, Cursor, Windsurf e qualquer cliente compatível com MCP. O servidor usa o transporte padrão stdio do MCP, tornando-o compatível com qualquer cliente que suporte o protocolo.

Como reporto problemas de segurança?

Envie um e-mail para security@arvo.guru com os detalhes. Consulte SECURITY.md para nossa política de segurança completa e processo de divulgação responsável.

Quais dados a IA pode acessar?

A IA pode acessar seus planos de treino, histórico de exercícios, recordes pessoais, acompanhamento de composição corporal e anotações do treinador. As ferramentas de escrita permitem salvar memórias, atualizar preferências e modificar treinos. Você controla o acesso por meio dos escopos da chave de API.

Isso funciona sem uma conta Arvo?

Não, você precisa de uma conta Arvo para gerar uma chave de API. Cadastre-se gratuitamente em arvo.guru.

Como atualizo para uma nova versão?

Se você usa npx -y arvo-mcp, ele busca automaticamente a versão mais recente. Para instalações globais, execute npm update -g arvo-mcp.

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`ARVO_API_KEY`	Sim	Sua chave de API do Arvo
`ARVO_BASE_URL`	Não	URL base da API (padrão: `https://arvo.guru`)

Requisitos

Node.js 18+
Uma conta Arvo (cadastre-se gratuitamente)

Relacionados

Procurando rastreamento de fitness com IA? Confira:

Arvo - Treinador de treinos com IA que cria programas de treinamento personalizados
Model Context Protocol - O protocolo aberto que alimenta esta integração

Licença

MIT - consulte LICENSE para detalhes.

🏋️ Acompanhe seus treinos de academia com IA
Comece com o Arvo →