@exerciseapi/mcp-server

@exerciseapi/mcp-server

Servidor MCP oficial para exerciseapi.dev — dê ao seu agente de codificação de IA acesso direto a mais de 2.198 exercícios verificados em 12 categorias.

Está criando um aplicativo de fitness, treino, exercício, reabilitação ou bem-estar com Claude Code, Cursor, Windsurf ou Cline? Pare de pedir ao seu agente para inventar dados de exercícios. Instale este servidor MCP e seu agente terá seis ferramentas que buscam exercícios reais e estruturados diretamente da biblioteca do exerciseapi.dev.

Por que isto existe

LLMs alucinam instruções de exercícios. Eles inventam grupos musculares. Misturam dicas de execução. Eles dirão alegremente para você fazer um "reverse-grip incline cable fly" com dicas de segurança que podem machucar alguém.

Este servidor dá ao seu agente acesso a:

• Mais de 2.198 exercícios em força, calistenia, yoga, pilates, mobilidade, fisioterapia, pliometria, alongamento e mais
• Dados musculares anatômicos reais — primários e secundários, músculos específicos, não apenas "peito" ou "pernas"
• Dicas de execução e notas de segurança escritas por humanos, não geradas
• Filtros de equipamento, dificuldade e categoria para que o agente possa montar treinos precisos
• Vídeos de demonstração para um subconjunto crescente de exercícios (e contando)

É um wrapper fino em torno da API REST do exerciseapi.dev. Toda a filtragem e busca são executadas no servidor — a camada MCP apenas as torna chamáveis como ferramentas.

Instalação

1. Obtenha uma chave de API gratuita

Cadastre-se em exerciseapi.dev/dashboard. O plano gratuito oferece 100 requisições/dia, o que é suficiente para desenvolvimento. Não é necessário cartão de crédito.

2. Adicione ao seu cliente MCP

Claude Desktop / Claude Code — adicione ao ~/.config/claude/claude_desktop_config.json (ou ao .mcp.json do seu projeto):

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Cursor — adicione ao .cursor/mcp.json no seu projeto:

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Windsurf, Cline, Zed — mesmo formato, cole na configuração MCP do seu cliente.

3. Reinicie seu agente

Reinicie o Claude Desktop / Cursor / Windsurf para que ele reconheça o novo servidor. Pronto.

Experimente

Após a instalação, pergunte ao seu agente algo como:

Encontre cinco exercícios de peito que eu possa fazer apenas com halteres, nível intermediário. Para cada um, mostre as dicas de execução.

Seu agente chamará search_exercises com os filtros corretos, receberá dados reais e responderá com exercícios precisos, provenientes da biblioteca. Sem alucinação.

Ou:

Estou criando um aplicativo de treino de corpo inteiro para iniciantes. Busque 8 exercícios entre empurrar, puxar e pernas que não precisem de equipamento.

Ou:

Qual é a diferença entre supino com barra e supino com halteres em termos de ativação muscular?

Ferramentas

Este servidor expõe seis ferramentas:

Ferramenta	O que faz
search_exercises	Busca na biblioteca por nome, categoria, músculo, equipamento ou dificuldade. Retorna até 100 exercícios.
get_exercise	Obtém detalhes completos de um único exercício por ID — instruções, dicas de execução, notas de segurança, variações, vídeo.
list_categories	Lista todas as 12 categorias de exercícios com contagens.
list_muscles	Lista músculos anatômicos disponíveis como filtros.
list_equipment	Lista tipos de equipamento disponíveis como filtros.
get_stats	Estatísticas gerais da biblioteca: contagem total, distribuição por categoria, cobertura de vídeo.

A referência completa das ferramentas está na página de documentação do MCP.

Por que exerciseapi.dev?

	exerciseapi.dev	ExerciseDB	free-exercise-db	API Ninjas
Número de exercícios	2.198 (meta de 10.000+)	~1.300	~800	~3.000
Categorias	12 (força, yoga, fisioterapia, mobilidade, pilates, etc.)	Somente força	Somente força	7 tipos
Palavras-chave de busca	✅ 5–10 por exercício	❌	❌	❌
Dicas de execução	✅ 3–4 por exercício	❌	❌	❌
Notas de segurança	✅ Detalhadas	❌	❌	Básicas
Músculos anatômicos específicos	✅	✅	❌	❌
Variações	✅ 3–5 por exercício	❌	❌	❌
Vídeos de demonstração	✅ Em crescimento	✅ GIFs	❌	❌
Servidor MCP	✅ Este pacote	❌	❌	❌
Plano gratuito	100 req/dia	Nenhum	N/A (estático)	100 req/mês
Plano pago a partir de	US$ 5/mês	US$ 10/mês	—	US$ 10/mês

Construído especificamente para desenvolvedores que usam agentes de codificação de IA. O schema, as descrições das ferramentas, o formato da documentação — tudo projetado para que um LLM possa entender e usar corretamente na primeira vez.

Configuração

Variáveis de ambiente obrigatórias

Variável	Descrição
EXERCISEAPI_KEY	Sua chave de API do exerciseapi.dev/dashboard. Obrigatória. O servidor será encerrado na inicialização se estiver ausente.

Variáveis de ambiente opcionais

Variável	Padrão	Descrição
EXERCISEAPI_BASE_URL	https://api.exerciseapi.dev	Substitui a URL base da API. Útil para self-hosting ou testes contra staging.

Solução de problemas

"Variável de ambiente EXERCISEAPI_KEY não definida" Você esqueceu de adicionar a chave à configuração do seu cliente MCP, ou não reiniciou o cliente após adicioná-la. Verifique o JSON no seu arquivo de configuração e reinicie.

"Chave de API inválida" A chave foi rejeitada. Gere uma nova em exerciseapi.dev/dashboard e atualize sua configuração.

"Cota diária atingida" Você atingiu o limite de 100 req/dia do plano gratuito. Aguarde até amanhã (reinicia à meia-noite UTC) ou faça upgrade em exerciseapi.dev/pricing.

O agente não está usando as ferramentas Duas causas comuns: (1) o servidor não iniciou — verifique os logs do servidor MCP do seu cliente, geralmente no console do desenvolvedor ou em um arquivo de log. (2) O agente não considera as ferramentas relevantes. Tente perguntar de forma mais explícita: "Use as ferramentas do exerciseapi para encontrar…"

Cold start é lento na primeira execução npx -y @exerciseapi/mcp-server baixa o pacote na primeira vez que você o usa. Para pular o download a cada reinicialização, instale globalmente: npm install -g @exerciseapi/mcp-server, depois altere command para exerciseapi-mcp na sua configuração.

Acesso direto à API (sem MCP)

Se preferir acessar a API REST diretamente em vez de usar MCP — por exemplo, se estiver criando uma integração no servidor ou se não estiver em um cliente MCP compatível — consulte exerciseapi.dev/docs. A mesma chave de API funciona para ambos.

Há também um prompt universal de copiar e colar na página inicial que você pode inserir em qualquer ferramenta de codificação de IA para obter uma integração funcional de uma só vez, sem necessidade de MCP.

Contribuindo

Issues e PRs são bem-vindos. Este servidor é intencionalmente um wrapper fino — se houver lógica que você queira alterar, ela provavelmente pertence à API REST (repositório privado). Abra uma issue primeiro se não tiver certeza.

Licença

MIT © Vegh Labs LLC

---

Construído por West Vegh. Se isso economizar um fim de semana de construção de infraestrutura de dados de exercícios, diga oi no dashboard ou envie uma mensagem para west@veghlabs.com.