RunDida — Running Tools for AI Agents

@rundida/mcp-server

面向 RunDida 的 MCP 服务 — 为 AI Agent 提供跑步专业知识。

十种工具，让 Claude、Cursor 或任何 MCP 客户端实时计算配速、心率区间、比赛成绩预测和马拉松倒计时，并查询 RunDida 的完整资料库：99 种跑步计算器、56 篇训练指南和 300 多场马拉松赛事（赛道、天气和报名数据），支持英语、中文和日语。免费、零配置、无需 API 密钥。

快速开始

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "rundida": {
      "command": "npx",
      "args": ["-y", "@rundida/mcp-server"]
    }
  }
}

Claude Code

claude mcp add rundida -- npx -y @rundida/mcp-server

Cursor / Windsurf

将以下内容添加到你的 MCP 配置中：

{
  "rundida": {
    "command": "npx",
    "args": ["-y", "@rundida/mcp-server"]
  }
}

可用工具

工具	类型	描述
list_tools	数据	浏览全部 99 种跑步计算器，查看说明
get_tool	数据	获取特定工具的详情、常见问题和来源
list_guides	数据	浏览全部 46 篇跑步指南，查看说明
get_guide	数据	获取指南详情、常见问题和相关工具
list_marathons	数据	列出 300 多场马拉松赛事，包含日期和地点
get_marathon	数据	获取马拉松赛事详情，包括天气和赛道概况
calculate_pace	计算	计算配速、时间或距离（三项中提供任意两项）
predict_race	计算	使用 Riegel 公式和 VO2max 估算预测比赛成绩
heart_rate_zones	计算	计算 5 个心率训练区间（Karvonen 方法）
marathon_countdown	计算	获取特定马拉松赛事的倒计时

数据工具会从 RunDida API 获取数据，并缓存 30 分钟。计算工具在本地运行，零延迟，无需调用 API。

使用示例

向你的 AI 助手提问：

• “如果我想在 3:30 内跑完马拉松，配速应该是多少？”
• “根据我 45 分钟的 10 公里成绩，预测我的马拉松完赛时间”
• “我的心率区间是多少？我 32 岁，静息心率为 52”
• “距离东京马拉松还有多少天？”
• “列出所有与营养相关的跑步计算器”
• “有哪些关于马拉松训练的跑步指南？”
• “介绍一下从沙发到 5 公里的指南”

关于 RunDida

RunDida（跑滴答）是一个面向各水平跑者的免费跑步工具平台：

• 90 多种交互式计算器 — 配速、心率区间、VO2max、比赛成绩预测、营养、装备尺码、天气影响等
• 29 个马拉松倒计时 — 实时计时器，附带比赛日天气预报、赛道概况和训练工具
• 免费 JSON API — 无需身份验证，支持 CORS，提供 OpenAPI 3.0 文档
• 多语言 — 英语、中文（中文）
• 可嵌入小组件 — 通过单行 iframe 嵌入任意计算器

所有工具均免费，无需注册账号。前往 rundida.com 体验。

工作原理

计算工具使用成熟的跑步科学公式：

公式	用途	描述
Riegel 公式	predict_race	预测不同距离的比赛成绩
Jack Daniels 方法	predict_race	根据比赛表现估算 VO2max
Karvonen 方法	heart_rate_zones	根据年龄和静息心率计算心率训练区间

要求

• Node.js >= 18
• 互联网连接（数据工具会从 rundida.com 获取数据）

Links

Resource	URL
RunDida Website	rundida.com
API Documentation	rundida.com/api
OpenAPI Spec	rundida.com/api/openapi.json
NPM Package	@rundida/mcp-server

License

MIT