开发智能体时，集成垂直领域工具是常见需求。对于跑步场景，计算 VDOT、训练配速或预测比赛时间通常依赖外部工具或手动公式。xby-running-formulas 是一个 MCP 服务器，它为 DeepSeek Harness 提供了这些计算能力。

插件介绍

这是一个由 xby-skill 维护的联网工具。它是一个提供全面的跑步计算工具的 MCP 服务器，包括 VDOT 计算、训练配速、比赛时间预测、速度标记、心率区间和配速转换等功能。

核心功能

该插件主要基于 Jack Daniels 和 McMillan 两种跑步公式体系提供计算服务：

  • Jack Daniels 公式

    • daniels_calculate_vdot: 根据 Jack Daniels 算法计算 VDOT。
    • daniels_calculate_training_paces: 根据给定 VDOT 获取推荐训练配速（轻松跑、马拉松配速、阈值跑、间歇跑、重复跑）。
    • daniels_predict_race_time: 基于已知比赛表现预测目标距离的比赛时间。

  • Riegel 公式

    • riegel_predict_race_time: 基于已知比赛表现，使用 Riegel 公式预测目标距离的比赛时间。

  • McMillan 公式

    • mcmillan_calculate_velocity_markers: 从比赛表现计算速度标记（vLT, CV, vVO2）。
    • mcmillan_predict_race_times: 基于单场比赛表现预测标准距离的比赛时间。
    • mcmillan_calculate_training_paces: 基于比赛表现计算所有区域的训练配速。
    • mcmillan_heart_rate_zones: 基于年龄、静息心率和最大心率（可选）计算心率训练区间。

  • 通用工具

    • set_xby_apikey: 在聊天中设置 API 密钥（自动持久化，重启有效）。
    • convert_pace: 在不同配速和速度单位之间进行转换。

安装与启用

通过以下命令从 GitHub 安装插件：

dsh plugin --profile web add github:xby_skill/xby-running-formulas

典型用法

在 DSH 交互中，可以直接调用上述功能。以下是几种典型的调用方式：

  1. 计算 VDOT
    输入距离（米）和时间（秒），获取 VDOT 值：
    daniels_calculate_vdot(distance, time)
  1. 配速单位转换
    在 min_km、min_mile、kmh、mph 之间转换数值：
    convert_pace(value, from_unit, to_unit)
  1. 计算心率区间
    输入年龄、静息心率和最大心率，获取训练区间：
    mcmillan_heart_rate_zones(age, resting_heart_rate, max_heart_rate)

注意事项

  • API 密钥: 使用前需要注册小笨羊官网获取 API 密钥。
  • 错误处理: convert_pace 函数在单位无效或转换不支持时会抛出 ValueError，调用时需注意参数校验。

总结

该插件为 DeepSeek Harness 提供了标准化的跑步数据计算能力，开发者可以通过简单的函数调用实现复杂的运动科学计算。更多详情可查看插件目录或源码仓库。