transition-mcp

Transition MCP是一款专为耐力运动爱好者设计的AI多项目教练技能，通过接入Transition平台API，为用户提供从日常训练到比赛准备的智能化运动管理方案。该技能基于Model Context Protocol (MCP)构建，支持跑步、骑行、游泳及铁人三项等多种运动类型，将专业级训练科学带入AI对话环境。

核心用法涵盖两大模式：对于非认证用户，可通过免费的Workout of the Day (WOD)端点获取随机生成的结构化训练，支持按运动类型和时长筛选；对于认证用户，在配置TRANSITION_API_KEY后，可访问完整功能包括：获取定制化训练计划、查看Performance Management Chart (PMC)监控训练负荷（CTL/ATL/TSB）、查询生理指标（FTP、阈值配速、心率区间）、与AI教练实时对话获取训练建议，以及将训练计划一键推送至Garmin设备。所有AI生成操作（训练计划生成与调整）采用异步机制，需轮询状态接口确认完成。

显著优点体现在其专业性与智能化的深度结合。首先，AI教练不仅提供通用建议，还能基于PMC数据判断运动员疲劳状态（TSB低于-20时提示休息），避免过度训练。其次，多项目支持满足铁人三项运动员的交叉训练需求，单一平台管理跑步、骑行、游泳数据。第三，与Garmin生态的无缝集成解决了"计划制定-设备执行"的断点问题。此外，免费额度（每日100次读取+3次AI请求）降低了体验门槛，清晰的Rate Limit机制帮助用户合理分配资源。

潜在缺点与局限性需要用户警惕。作为T3级个人开发者项目，其长期维护稳定性不及商业软件。功能上，异步操作模式增加了使用复杂度，用户需手动轮询状态；免费版AI请求额度（3次/天）对于深度用户明显不足。此外，该技能完全依赖Transition云服务的可用性，离线环境无法使用，且所有运动数据需上传至第三方服务器，对数据隐私敏感的用户可能存在顾虑。输入验证方面，虽有基础类型检查，但缺乏严格的参数边界验证。

适合的目标群体主要包括：严肃耐力运动员（特别是铁三选手）、追求科学训练数据的业余跑者/骑行者、以及需要动态调整训练计划的忙碌职场人士。对于仅偶尔运动的休闲用户，免费WOD功能已能满足需求；而准备马拉松、Ironman等赛事的竞技选手，则可利用PMC监控和AI自适应功能优化周期训练。

使用风险方面，除常规的第三方服务依赖风险（服务中断、API变更）外，用户需注意：运动建议的AI生成特性意味着算法可能无法完全替代真人教练对个体特殊情况（如伤病史、药物影响）的判断；Rate Limit可能导致在关键训练日无法获取即时建议；API Key管理不当存在泄露风险，尽管代码本身安全，但用户需妥善保管密钥。建议在高强度训练决策前，仍咨询专业医疗或教练意见。