hevy-mcp

hevy-mcp : pont MCP permettant un accès conversationnel aux données d'entraînement Hevy

hevy-mcp, construit par Swrm Io, est un serveur MCP qui connecte les données d'entraînement Hevy aux assistants IA, permettant des requêtes conversationnelles et des actions de routine automatisées. L'outil expose les journaux d'entraînement, la gestion des routines, un index de modèles d'exercice et des mesures corporelles via l'API Hevy afin que les modèles puissent analyser le volume d'entraînement et suggérer des modifications de plan. Il sécurise les clés API avec des variables d'environnement et fonctionne sur MCP stdio. Les utilisateurs cibles sont les clients Hevy et les développeurs construisant des entraîneurs personnels alimentés par l'IA qui souhaitent un accès programmatique et interrogeable aux données d'entraînement.

Permet un accès direct et des modifications basées sur le chat aux données Hevy d'un utilisateur

L'outil transforme l'API Hevy en une source de données soutenue par MCP, afin que les assistants IA puissent récupérer et agir sur les informations d'entraînement. Les points de terminaison pris en charge incluent l'historique d'entraînement paginé et les totaux, la liste et les mises à jour des routines, les modèles d'exercice et les entrées de mesures corporelles. Les résultats typiques sont des requêtes conversationnelles sur les sessions passées et les modifications de routine enregistrées, avec des actions émises par un assistant qui appelle les points de terminaison Hevy au nom de l'utilisateur.

L'utilité de l'analyse reflète la qualité des données Hevy et les résultats de l'assistant choisi

L'analyse générée dépend de deux sources de données : les journaux Hevy enregistrés de l'utilisateur et l'assistant produisant l'interprétation. Les retours de la communauté soulignent spécifiquement les vérifications d'équilibre des groupes musculaires et l'analyse du volume comme résultats pratiques. Ces résultats fournissent des signaux utilisables pour les décisions d'entraînement, mais toute recommandation de coaching prescriptive doit être vérifiée par rapport aux entrées d'entraînement brutes ou à un coach qualifié, car l'outil fournit des données plutôt qu'une validation indépendante.

Nécessite un environnement spécifique et des prérequis de compte pour fonctionner

Le déploiement exige Node.js et des outils MCP : Node.js v18 ou supérieur est requis, et un client compatible MCP tel que Claude Desktop doit être présent pour utiliser le transport stdio. Une clé API Hevy valide et un compte Hevy Pro sont nécessaires pour l'accès à l'API. Les options d'installation incluent l'invocation npx ou le clonage et la construction du dépôt avec Node, ce qui l'aligne avec les flux de travail de configuration orientés développeurs.

Convient aux flux de travail des développeurs mais le routage des données dépend des choix du client et de l'assistant

Le serveur est orienté vers les développeurs construisant des intégrations d'agents, et le projet est construit par la communauté plutôt qu'un produit officiel de Hevy. Il est conçu pour fonctionner sur tout système prenant en charge le Modèle de Protocole de Contexte via stdio, donc comment et où les données quittent un hôte dépend de la configuration du client MCP et de l'assistant. Le serveur utilise des variables d'environnement pour les clés API, ce qui aide à garder les informations d'identification hors du code source pendant le travail d'intégration.

Une intégration pratique pour les développeurs et les utilisateurs de Hevy qui acceptent l'analyse basée sur les modèles

L'outil est une option pratique pour les développeurs et les clients de Hevy qui ont besoin d'un accès conversationnel aux enregistrements d'entraînement et aux modifications de routine dans l'application ; sa valeur dépend de la qualité des entraînements enregistrés et de l'assistant produisant des interprétations. Attendez-vous à utiliser l'outil comme un conduit de données et à associer les recommandations générées à un examen manuel ou à une supervision d'expert lors de l'application de changements d'entraînement à un programme.