MCP Strava Server

MCP Strava 服务

一个将 Strava 与 Claude for Desktop 集成的模型上下文协议（MCP）服务，可借助 AI 分析你的健身活动。

功能

• ⭐ 路线生成 - 推荐往返路线并提供 Google Maps 链接（无需 API 密钥）
• ⭐ 热门路线 - 发现附近热门的 Strava 路段，并获取一条经过这些路段的 Google Maps 环线
• OAuth 身份验证，支持自动刷新和持久保存令牌
• 活动分析 - 按 ID 获取任意活动的详情，或浏览近期活动
• 数据流 - 获取任意活动的心率、配速、海拔、步频、功率和 GPS 数据
• 分段数据 - 获取每圈的距离、时间、速度、海拔和心率
• 个人最佳成绩 - 获取跑步的最快 400 米、1k、1 英里、5k、10k 等成绩，以及配速和个人纪录排名
• 分页搜索 - 按日期范围查找活动，支持完整分页
• 历史对比 - 按年份比较各月数据
• 统计数据 - 全部历史统计、每周/月汇总
• 筛选 - 按活动类型筛选（跑步、骑行、游泳等）

可用工具

工具	描述
auth_strava	使用 Strava 授权（打开浏览器）
logout	清除已存储的令牌以切换账号
last_activity	获取最近一次活动的详情
get_activity	按 ID 获取任意活动
recent_activities	列出最近 10 项活动
search_activities	分页搜索，可选日期范围（before/after epoch、page、per_page）
athlete_stats	全部历史统计数据（骑行、跑步、游泳）
activities_by_type	按运动类型筛选活动
weekly_summary	汇总过去 7 天的数据
monthly_summary	汇总过去 30 天的数据
month_summary	汇总指定月份/年份的数据
compare_months	比较两个月份（例如，2025 年 1 月与 2026 年 1 月）
get_streams	获取最近一次活动的心率数据
get_activity_streams	获取任意活动的完整数据流（HR、配速、海拔、步频、功率、GPS 等）
get_laps	获取任意活动的分段数据（距离、时间、速度、海拔、HR）
get_best_efforts	获取跑步的个人最佳成绩（400 米、1k、1 英里、5k、10k、……），以及配速和个人纪录排名
suggest_route	生成往返路线，并获取用于导航的 Google Maps 链接
popular_routes	查找附近热门的 Strava 路段，并生成一条经过这些路段的 Google Maps 路线

设置

1. 克隆仓库

git clone https://github.com/MariyaFilippova/mcp-strava.git
cd mcp-strava

2. 配置 Strava API 凭据

从 Strava API 设置 获取凭据。

创建或编辑 src/main/resources/.env：

CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. 构建项目

./gradlew shadowJar

JAR 文件位于：build/libs/strava-mcp-server-2.1.0-all.jar

4. 配置 Claude for Desktop

编辑 Claude 的配置文件：

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

添加 MCP 服务：

{
  "mcpServers": {
    "strava": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/mcp-strava/build/libs/strava-mcp-server-2.1.0-all.jar"
      ]
    }
  }
}

重启 Claude for Desktop。

使用示例

配置完成后，你可以向 Claude 提出以下问题：

• “显示我最近的 Strava 活动”
• “我全部历史跑步统计数据是什么？”
• “比较我 2025 年 1 月和 2026 年 1 月的数据”
• “汇总我本周的骑行情况”
• “我本月的训练情况与上个月相比如何？”
• “显示活动 123456789 的分段数据”
• “分析我最近一次跑步的心率和海拔数据”
• “查找我 2025 年 3 月的所有活动”
• “推荐一条从美国纽约中央公园出发的 5km 跑步路线”
• “从 48.8566, 2.3522 出发生成一条 10km 骑行路线”
• “查找美国纽约中央公园附近热门的跑步路段”
• “显示巴黎 10km 范围内的热门骑行路线”

身份验证

首次使用时，服务会打开浏览器以进行 Strava 授权。令牌会保存到 ~/.strava-mcp-token.json，并在过期时自动刷新。

如需切换账户，请使用 logout 工具清除已保存的令牌。

许可证

MIT