عن المشروع

Hevy MCP Server هو خادم مفتوح المصدر لبروتوكول سياق النماذج (MCP) مخصص لتطبيق Hevy للياقة وتتبع التمارين. يتيح لمساعدي الذكاء الاصطناعي قراءة وتحليل وإنشاء وتحديث تمارين Hevy وروتيناته وقوالب التمارين والقياسات الجسدية عبر طلبات Hevy API الموثّقة. يلزم مفتاح Hevy API، المتاح مع Hevy PRO. يسجّل الخادم 23 أداة ضمن فئات تشمل تحليل التدريب، والتمارين، والروتينات، ومجلدات الروتينات، وقوالب التمارين، وسجل التمارين، والقياسات الجسدية، والتشخيص. تدعم الأدوات للقراءة فقط الاستكشاف، بينما تُتاح أدوات الإنشاء والتحديث مع تعليقات MCP الخاصة بالتغيير حتى يتمكن العملاء المتوافقون من طلب التأكيد. لا يوفر Hevy API حالياً أي نقاط نهاية للحذف، لذا لا تُقدَّم أدوات حذف. يمكن للمستخدمين الاتصال عبر نقطة نهاية Cloudflare Streamable HTTP المستضافة على https://mcp.hevy-mcp.dev/mcp، والتي تتطلب إرسال مفتاح Hevy API كرمز bearer، أو التشغيل محلياً عبر npx أو bunx أو Docker. تدعم نقطة النهاية المستضافة OAuth 2.1 للعملاء مثل Claude.ai الذين لا يستطيعون إرسال ترويسات ثابتة. توفر حزمة CLI منفصلة، @chrisdoc/hevy-cli، وصولاً طرفياً إلى التمارين والروتينات والتمارين والقياسات الجسدية. ينظَّم المستودع كمساحة عمل تضم حزمًا لعميل Hevy، وعمليات النطاق، ونواة MCP، ومهايئ Node.js stdio، ومهايئ Cloudflare Worker، وCLI مستقل. يعتمد HevyClient العام على Promise، بينما تستخدم العمليات الداخلية Effect لجداول إعادة المحاولة والمهلات ومعالجة المقاطعة. تستخدم عقود إدخال الأدوات واستجاباتها مخططات Zod.