Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/TiagoTi/mcp-academia-server
cd mcp-academia-serverThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add academia-server -- node /path/to/mcp-academia-server/index.jsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
academia-server's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Search exercises by muscle group
- List all available muscle groups
- Partial name search for exercises
- Retrieve detailed exercise information including sets and reps
- Centralized database management for workout routines
Tools 5
buscar_exercicios_por_grupoSearch for exercises filtered by muscle group.listar_grupos_muscularesList all available muscle groups in the database.buscar_exercicio_por_nomeSearch for exercises by name using partial, case-insensitive matching.listar_todos_exerciciosList all registered exercises organized by muscle group.obter_detalhes_exercicioGet complete details for a specific exercise by its ID.Try it
Original README from TiagoTi/mcp-academia-server
Servidor MCP: mcp-academia-server
Quando começei pesquisar sobre, a maioria dos tutoriais explicavam com executar
o servidor mcp dentro de um script com outros componente, como o código que conecta
a uma llm, o arquivo via-stdio.ts é uma extração desse exemplo.
Por outro lado, como engenheiro de software fiquei imaginando como eu podeira fazer para usar o mesmo servidor em mais de uma solução então o arquivo index.ts é um exeplo que utiliza o conceito: Servidor MCP Centralizado via HTTP/SSE
Desenvolvimento
Executando teste
bun run cliente.ts
Gerando publicação via docker
criando a imagem
docker image build \
--pull -t mcp-server-academia .
executando
docker run --restart=always --name mcp-server-academia -d -p 3401:3000 mcp-server-academia
O que ess MCP Especificamente Faz?
Baseado no código e na resposta do tools/list, o servidor MCP é especializado em gerenciamento e consulta de exercícios de academia. Ele oferece as seguintes ferramentas (copiadas da resposta do curl para clareza):
buscar_exercicios_por_grupo:
Descrição: Busca exercícios filtrando por grupo muscular. Grupos disponíveis: Costas (dorsais, lombar), Ombros (deltoides), Pernas, Peito (peitoral), Braços (Bíceps, Tríceps, Antebraço). Entrada: {"grupo_muscular": "string"} (ex: "Pernas"). Saída: Lista de exercícios com séries, repetições, intervalo e observações. listar_grupos_musculares:
Descrição: Lista todos os grupos musculares disponíveis no banco de dados. Entrada: Nenhuma (objeto vazio). Saída: Lista de grupos (ex: "- Pernas
- Peito (peitoral) ..."). buscar_exercicio_por_nome:
Descrição: Busca exercícios por nome (busca parcial, case-insensitive). Entrada: {"nome": "string"} (ex: "agachamento"). Saída: Detalhes dos exercícios encontrados, incluindo ID, grupo, séries, etc. listar_todos_exercicios:
Descrição: Lista todos os exercícios cadastrados, agrupados por grupo muscular. Entrada: Nenhuma. Saída: Lista completa, organizada por grupos. obter_detalhes_exercicio:
Descrição: Obtém detalhes completos de um exercício específico pelo ID. Entrada: {"id": number} (ex: 1). Saída: Informações detalhadas (nome, grupo, séries, repetições, intervalo, observações).