wger-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
wger-mcp
Serveur MCP distant (TypeScript) qui relie claude.ai (connecteur personnalisé) à une instance wger auto-hébergée.
Multi-utilisateur et sans état : chaque utilisateur met sa clé API wger dans l'URL du
connecteur, https://mcp-gym.solare.dev/<clé>/mcp. Le serveur ne stocke rien.
Version wger testée : 2.8.0-dev.5 (/api/v2/version/, image wger/server:latest,
vérifiée le 2026-11-16). Le schéma OpenAPI de cette instance est versionné dans
wger-schema.json.
Outils
Outil | Rôle | Endpoints wger |
| Recherche par nom dans une langue ( |
|
| Routines de l'utilisateur (hors templates) |
|
| Jours → slots (superset si plusieurs entrées) → exercices avec séries/reps/charge/RIR/repos : valeur de base, max (fourchette), progression |
|
| Enregistre des séries (kg) d'un exercice |
|
| Séries par jour puis par exercice, avec e1RM par série |
|
| Meilleur e1RM et e1RM le plus récent sur N jours, et TM |
|
| Charges par % d'un TM ou d'un 1RM (calcul pur) | aucun |
| Crée une routine simple : jours, exercices, séries × reps, charge et RIR optionnels |
|
Calculs (src/domain/strength.ts) :
e1RM = Epley ajusté RIR,
w × (1 + (reps + rir) / 30);nullsireps + rir > 12. RIR absent = 0. Seules les séries en kg ou lb (lb converties) et comptées en répétitions sont retenues.TM = 90 % du e1RM, arrondi au 2,5 kg le plus proche (ratio et pas paramétrables).
Related MCP server: hevy-coach
Architecture
src/
index.ts démarrage : config, écoute, arrêt propre
app.ts Express + StreamableHTTPServerTransport STATELESS
(1 McpServer par requête, POST /:apiKey/mcp uniquement)
config.ts variables d'environnement (validées avec zod)
auth/credentials.ts SEUL module qui sait d'où vient l'auth (clé dans l'URL, 40 hex)
wger/client.ts HTTP typé : Authorization: Token, timeout, pagination, erreurs typées
wger/api.ts ressources wger : endpoints, filtres, schémas de réponse (zod)
wger/mapping.ts conversion des payloads wger vers le domaine (WorkoutLog → SetResult…)
domain/types.ts types métier, sans aucun nom de champ wger
domain/strength.ts maths pures : e1RM, TM, charges par %
tools/index.ts outils MCP (schémas d'entrée, orchestration)
tools/format.ts présentation JSON compacte pour le modèleInvariants :
Sans état : aucune session MCP, aucun cache inter-requêtes, aucune donnée stockée.
Auth isolée : le reste du code ne voit qu'un
WgerCredentialsopaque. Passer à OAuth revient à modifiercredentials.ts.Clé invalide ⇒ 404, impossible à distinguer d'un chemin inconnu.
GETetDELETEavec une clé valide ⇒ 405.Aucun log ne contient l'URL ni la clé : on ne logue que le template de route (
POST /:apiKey/mcp 200 31ms). Un test unitaire le vérifie.Noms de champs wger confinés à
src/wger/:api.tspour les requêtes et schémas,mapping.tspour la lecture. Les réponses sont validées par zod : si l'API change, l'erreur est explicite au lieu d'unundefinedsilencieux.
Compatibilité wger 2.8 : champs vérifiés
Vérifiés sur le schéma ET par des appels réels :
Ressource | Constat |
|
|
unités |
|
précision | weight / repetitions : 2 décimales ; rir : 1 décimale et < 10. Au-delà, wger répond 400 : le serveur arrondit avant l'envoi. |
séance auto | Sans |
|
|
recherche |
|
routines | Modèle |
filtres |
|
pagination |
|
suppressions | Supprimer une séance supprime aussi ses logs. Supprimer un log laisse la séance. |
create_routine
Le schéma permet une création propre, mais pas atomique : wger n'a pas d'endpoint
transactionnel. L'outil enchaîne donc routine → day → slot → slot-entry → configs, et en
cas d'échec il supprime la routine, ce qui efface tout son arbre (vérifié). L'appel réussit
entièrement ou ne laisse rien.
Jours dans l'ordre du cycle. Un jour peut être
rest: true, sans exercice.Par exercice :
sets,reps,weight(kg) optionnel,riroptionnel, en itération 1.fit_in_weekvauttruepar défaut : chaque cycle est complété par des jours de repos pour durer exactement 7 jours, à partir destart(vérifié viadate-sequence-display). Pour lun/mer/ven :startun lundi et jours[A, repos, B, repos, C].Limites wger : nom de routine ≤ 25 caractères, nom de jour ≤ 20,
end ≥ start.Hors périmètre volontaire : fourchettes (
max-*-config), progression (itérations > 1), supersets, temps de repos. Ils sont lisibles viaget_routinemais pas créables ici.
Configuration
Variable | Défaut | Rôle |
| requis | Racine wger vue du serveur, sans |
|
| Port HTTP |
|
| Timeout de chaque appel wger |
|
| Langue des noms d'exercices si l'appel n'en précise pas (ex. |
Déploiement
# docker-compose.yml (extrait)
services:
wger-mcp:
build: .
restart: unless-stopped
environment:
WGER_BASE_URL: http://wger-nginx-1
DEFAULT_LANGUAGE: fr
networks: [figutab_default]
networks:
figutab_default:
external: truemcp-gym.solare.dev {
reverse_proxy wger-mcp:8000
}Connecteur claude.ai : https://mcp-gym.solare.dev/<clé API wger>/mcp. La clé se trouve
dans wger, sous Paramètres → Clé API.
L'image tourne en utilisateur node, avec un HEALTHCHECK sur GET /healthz qui
n'appelle pas wger.
Derrière Cloudflare (proxy), le domaine doit rester à un seul niveau de sous-domaine
(mcp-gym.solare.dev, pas mcp.gym.solare.dev) : le certificat gratuit Cloudflare ne
couvre que *.solare.dev.
La clé est dans l'URL : ne pas activer les access logs Caddy pour ce site (Caddy n'en écrit
pas sans directive log), ou alors masquer le chemin.
Développement
Node ≥ 22.18. Les tests s'exécutent directement en TypeScript (type stripping natif) avec
node:test, sans dépendance de test.
npm ci
npm run build # tsc → dist/
npm test # typecheck + tests unitaires (aucun réseau)Test de bout en bout contre une vraie instance, ignoré par défaut. Il crée une séance dédiée, un log et une routine, puis les supprime même en cas d'échec :
WGER_E2E_BASE_URL=https://gym.solare.dev WGER_API_KEY=<clé de test> npm run test:e2eDerrière un proxy HTTP, ajouter NODE_USE_ENV_PROXY=1 (le fetch de Node ignore
HTTPS_PROXY sans cette variable).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Talk to your own gym log. Reps: Gym Workout Log (repsworkout.com) is a workout log for iPhone and Android. Connect it to Claude, ChatGPT or any MCP client to read your workout history, PRs, lift progression, weekly summaries, routines and training plan, and to save routines and plans after you confirm them. It never logs a workout for you and can’t delete your history. Sign in with an e-mail code, Apple or Google; new users can create a free account while connecting, then get the app to log workouts.
Pace is a remote MCP server that exposes wearable and fitness data to Claude via the Model Context Protocol. It connects to Garmin, Oura, Whoop, Polar, Fitbit and 20+ devices and provides 15 tools for querying sleep, activity, recovery, and training data. Hosted on Google Cloud Run, OAuth 2.1 authentication, Streamable HTTP transport. Instructions: First you need to create an account at: https://pacetraining.co and connect your wearables. After that you can connect the remote Server via Custom Connector in Claude and OAuth 2.1 Flow startet.
Unofficial Wger MCP — wraps wger Workout Manager REST API (free, no auth for read)
Connect Claude, Cursor or any MCP client to your GymUp training data.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceRemote MCP server for natural-language calorie/macro and weight tracking, designed to connect to Claude.ai as a custom connector.-
- AlicenseNot gradedqualityDmaintenanceMCP server that connects Claude to the Hevy fitness app, enabling AI-driven personalized strength coaching by reading lifting history and programming workouts.MIT
- AlicenseNot gradedqualityCmaintenanceA personal remote MCP server that lets Claude read your Hevy workout data and MacroFactor nutrition data directly in conversation, with read-only tools for workouts, body measurements, macros, and weight trends.MIT
- AlicenseNot gradedqualityBmaintenanceSelf-hosted fitness tracking MCP server that gives AI assistants access to your nutrition, training, weight, sleep, and accomplishment data via 77 tools and 5 resources. Enables natural-language logging and querying of personal health metrics through Claude or ChatGPT.12 npm1BSD 2-Clause "Simplified"