内容
# @rundida/mcp-server
跑滴答综合跑步工具平台的MCP服务器。
为您的AI助手提供92种跑步计算器、46种训练指南、44+马拉松赛事、配速/时间/距离计算、比赛时间预测和心率训练区间的访问权限。
[](https://rundida.com)
[](https://www.npmjs.com/package/@rundida/mcp-server)
[](LICENSE)
## 快速开始
### Claude Desktop
将以下内容添加到您的 `claude_desktop_config.json` 文件中:
```json
{
"mcpServers": {
"rundida": {
"command": "npx",
"args": ["-y", "@rundida/mcp-server"]
}
}
}
```
### Claude 代码
```bash
claude mcp add rundida -- npx -y @rundida/mcp-server
```
### Cursor / Windsurf
将以下内容添加到您的MCP配置中:
```json
{
"rundida": {
"command": "npx",
"args": ["-y", "@rundida/mcp-server"]
}
}
```
## 可用工具
| 工具 | 类型 | 描述 |
|------|------|-------------|
| `list_tools` | 数据 | 浏览所有 [92种跑步计算器](https://rundida.com) 并查看描述 |
| `get_tool` | 数据 | 获取特定工具的详细信息、常见问题和来源 |
| `list_guides` | 数据 | 浏览所有 [46种跑步指南](https://rundida.com/guide/) 并查看描述 |
| `get_guide` | 数据 | 获取指南的详细信息、常见问题和相关工具 |
| `list_marathons` | 数据 | 列出 [44+马拉松赛事](https://rundida.com/marathon/) 及其日期和地点 |
| `get_marathon` | 数据 | 获取马拉松赛事的详细信息,包括天气和赛道概况 |
| `calculate_pace` | 计算 | 计算配速、时间或距离(提供任意两个) |
| `predict_race` | 计算 | 使用Riegel公式和VO2max估算预测比赛时间 |
| `heart_rate_zones` | 计算 | 计算5个心率训练区间(Karvonen方法) |
| `marathon_countdown` | 计算 | 获取特定马拉松赛事的倒计时 |
**数据工具** 从 [跑滴答API](https://rundida.com/api/) 获取数据,缓存时间为30分钟。**计算工具** 在本地运行,零延迟,无需调用API。
## 示例用法
询问您的AI助手:
- "如果我想在3:30内完成马拉松,我的配速应该是多少?"
- "根据我的10K成绩45分钟,预测我的马拉松时间"
- "我的心率区间是多少?我32岁,静息心率52"
- "距离东京马拉松还有多少天?"
- "给我展示所有与营养相关的跑步计算器"
- "你们有哪些关于马拉松训练的跑步指南?"
- "给我介绍一下从零开始到5K的指南"
## 关于跑滴答
[**跑滴答**](https://rundida.com) 是一个免费的跑步工具平台,适用于所有级别的跑步者:
- **[90+交互式计算器](https://rundida.com)** — 配速、心率区间、VO2max、比赛预测、营养、装备尺寸、天气影响等
- **[29个马拉松倒计时](https://rundida.com/marathon/)** — 实时计时器,比赛日天气预测,赛道概况和训练工具
- **[免费JSON API](https://rundida.com/api/)** — 无需身份验证,支持CORS,[OpenAPI 3.0文档](https://rundida.com/api/openapi.json)
- **多语言支持** — 英语,中文(简体)
- **可嵌入的小工具** — 单行iframe嵌入任意计算器
所有工具都是免费的,不需要账户。在 [rundida.com](https://rundida.com) 上试用它们。
## 工作原理
计算工具使用成熟的跑步科学公式:
| 公式 | 使用于 | 描述 |
|---------|---------|-------------|
| **Riegel公式** | `predict_race` | 不同距离的比赛时间预测 |
| **Jack Daniels方法** | `predict_race` | 根据比赛表现估算VO2max |
| **Karvonen方法** | `heart_rate_zones` | 根据年龄和静息心率计算心率训练区间 |
## 要求
- Node.js >= 18
- 互联网连接(数据工具从 [rundida.com](https://rundida.com) 获取数据)
## 链接
| 资源 | URL |
|----------|-----|
| **跑滴答官网** | [rundida.com](https://rundida.com) |
| **API文档** | [rundida.com/api](https://rundida.com/api/) |
| **OpenAPI规范** | [rundida.com/api/openapi.json](https://rundida.com/api/openapi.json) |
| **NPM包** | [@rundida/mcp-server](https://www.npmjs.com/package/@rundida/mcp-server) |
## License
MIT