transition-mcp

🏃 AI多项目运动私教与训练分析

Transition官方推出的AI运动教练技能,为跑步、骑行、游泳及铁人三项爱好者提供个性化训练计划与实时数据分析,科学提升运动表现。

收藏
6.2k
安装
2.3k
版本
v1.0.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

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管理不当存在泄露风险,尽管代码本身安全,但用户需妥善保管密钥。建议在高强度训练决策前,仍咨询专业医疗或教练意见。

安全解读

核心功能

transition-mcp 是一款专为耐力运动爱好者设计的AI教练API工具,集成了训练计划管理、实时表现分析和智能交互 coaching 三大核心模块。

主要功能亮点

| 功能模块 | 说明 |
|---------|------|
| **每日训练(WOD)** | 免费获取随机结构化训练,支持跑步、骑行、游泳、力量四种运动类型,时长10-300分钟可调 |
| **个性化训练计划** | 基于AI生成完整周期化训练方案,自动适配用户目标和能力水平 |
| **动态计划调整** | 根据疲劳状态、赛程变化或伤病情况智能调整整个训练计划 |
| **PMC表现管理图** | 专业级CTL(体能)、ATL(疲劳)、TSB(状态)三项指标追踪 |
| **AI教练对话** | 流式响应的实时问答,获取训练建议、恢复指导等 |
| **Garmin同步** | 一键推送结构化训练至Garmin设备 |

训练科学特色

该Skill深度整合运动生理学指标:

  • TSB预警机制:TSB低于-20时自动提示疲劳风险,建议减载或休息
  • 阈值功率/配速管理:自动追踪FTP、阈值配速、心率区间等关键指标
  • 异步生成机制:AI计划生成采用后台处理+状态轮询,避免长时间阻塞

优势分析

1. 专业度突出:PMC图表是职业运动员和资深教练的标准工具,远超普通健身App的数据维度
2. 多项目整合:唯一同时覆盖跑步、骑行、游泳及铁人三项的MCP工具

3. 灵活性高:免费WOD端点让未注册用户也能即时受益;付费层级满足严肃训练需求

4. 生态对接:原生Garmin支持,无缝衔接主流运动硬件

局限性与注意事项

| 方面 | 说明 |
|-----|------|
| **AI调用限制** | 免费用户每日仅3次AI端点调用(chat/adapt/generate),需合理规划使用 |
| **异步延迟** | 计划生成/adapt需轮询状态,非即时完成,交互设计需考虑等待体验 |
| **数据来源依赖** | 所有功能完全依赖Transition服务端,无本地离线能力 |
| **运动类型限制** | 不支持球类、健身等其他运动类型 |

安全评估

  • 传输安全:全站HTTPS (TLS 1.2+)
  • 密钥管理:API Key通过环境变量获取,无硬编码风险
  • 隐私合规:符合CLS隐私规范,无敏感信息泄露
  • 来源评级:T3级个人开发者项目,代码结构清晰但建议持续关注更新

适用人群

  • 铁三/马拉松备赛者:需要周期化计划和PMC监控的严肃运动员
  • 结构化训练新手:希望通过科学方法替代盲目堆跑量的进阶爱好者
  • 多项目交叉训练者:需要统一管理跑步、骑行、游泳数据的用户
  • 教练辅助工具:为线下教练提供AI数据支持和计划生成效率工具

常规风险提示

1. 运动损伤风险:AI建议不能替代专业医疗判断,伤痛时应优先咨询医生而非仅调整计划
2. 过度训练风险:TSB指标虽有参考价值,但个体恢复能力差异大,需结合主观疲劳感综合判断

3. 数据隐私:运动表现数据存储于Transition第三方服务器,敏感用户应审阅其隐私政策

4. 服务可用性:免费端点依赖第三方服务稳定性,关键训练日建议提前获取计划

transition-mcp 内容

examples文件夹
mcp文件夹
手动下载zip · 9.0 kB
curl-examples.shtext/x-shellscript
请选择文件