hevy-mcp: جسر MCP يمكّن الوصول الحواري إلى بيانات تمارين Hevy
hevy-mcp، الذي تم بناؤه بواسطة Swrm Io، هو خادم MCP يربط بيانات تمارين Hevy بمساعدي الذكاء الاصطناعي، مما يمكّن الاستفسارات الحوارية والإجراءات الروتينية المؤتمتة. الأداة تعرض سجلات التمارين، إدارة الروتين، فهرس قوالب التمارين، وقياسات الجسم عبر واجهة برمجة تطبيقات Hevy بحيث يمكن للنماذج تحليل حجم التدريب واقتراح تعديلات على الخطط. تؤمن مفاتيح واجهة برمجة التطبيقات باستخدام متغيرات البيئة وتعمل عبر MCP stdio. المستخدمون المستهدفون هم عملاء Hevy والمطورون الذين يبنون مدربين شخصيين مدعومين بالذكاء الاصطناعي الذين يرغبون في الوصول البرمجي والقابل للاستعلام إلى بيانات التمارين.
يتيح الوصول المباشر، المدفوع بالدردشة، والتعديلات على بيانات Hevy الخاصة بالمستخدم
تحول الأداة واجهة برمجة التطبيقات Hevy إلى مصدر بيانات مدعوم من MCP، بحيث يمكن للمساعدين الذكائيين استرجاع المعلومات المتعلقة بالتمارين والتصرف بناءً عليها. تشمل نقاط النهاية المدعومة تاريخ التمارين المرقم وإجمالي العد، قوائم الروتين والتحديثات، قوالب التمارين، وإدخالات قياسات الجسم. النتائج النموذجية هي استفسارات حوارية حول الجلسات السابقة وتعديلات الروتين المحفوظة، مع إجراءات تصدر من مساعد يستدعي نقاط نهاية Hevy نيابة عن المستخدم.
تعكس فائدة التحليل جودة بيانات Hevy ومخرجات المساعد المختار
يعتمد التحليل الناتج على مصدرين للبيانات: سجلات Hevy المسجلة للمستخدم والمساعد الذي ينتج التفسير. تسلط تعليقات المجتمع الضوء بشكل خاص على فحوصات عدم توازن مجموعات العضلات وتحليل الحجم كمخرجات عملية. توفر تلك النتائج إشارات قابلة للاستخدام لاتخاذ قرارات التدريب، لكن يجب التحقق من أي توصية تدريبية وصفية مقابل إدخالات التمارين الخام أو مدرب مؤهل، لأن الأداة تزود بالبيانات بدلاً من التحقق المستقل.
يتطلب بيئة محددة ومتطلبات حساب للعمل
يتطلب النشر Node.js وأدوات MCP: يتطلب Node.js الإصدار 18 أو أعلى، ويجب أن يكون هناك عميل متوافق مع MCP مثل Claude Desktop لاستخدام نقل stdio. مفتاح API صالح لحساب Hevy وحساب Hevy Pro ضروريان للوصول إلى واجهة برمجة التطبيقات. تشمل خيارات التثبيت استدعاء npx أو استنساخ وبناء المستودع باستخدام Node، مما يتماشى مع سير العمل الموجه للمطورين.
يتناسب مع سير عمل المطورين لكن توجيه البيانات يعتمد على اختيارات العميل والمساعد
الخادم موجه نحو المطورين الذين يبنون تكاملات الوكلاء، والمشروع مبني من قبل المجتمع بدلاً من أن يكون منتج Hevy رسمي. تم تصميمه للعمل على أي نظام يدعم بروتوكول سياق النموذج عبر stdio، لذلك كيف وأين تترك البيانات المضيف يعتمد على تكوين عميل MCP والمساعد. يستخدم الخادم متغيرات البيئة لمفاتيح API، مما يساعد في إبقاء بيانات الاعتماد بعيدة عن كود المصدر أثناء العمل على التكامل.
تكامل عملي للمطورين ومستخدمي Hevy الذين يقبلون التحليل القائم على النماذج
الأداة هي خيار عملي للمطورين وعملاء Hevy الذين يحتاجون إلى الوصول الحواري إلى سجلات التمارين وتعديلات الروتين داخل التطبيق؛ تعتمد قيمتها على جودة التمارين المسجلة والمساعد الذي ينتج التفسيرات. توقع استخدام الأداة كقناة بيانات ومطابقة التوصيات المولدة مع المراجعة اليدوية أو الإشراف الخبير عند تطبيق تغييرات التدريب على برنامج.
