Strava健身分析服务器

一个集成Strava与Claude for Desktop的模型上下文协议服务器,提供AI驱动的健身活动分析功能。

  • by MariyaFilippova
  • Kotlin
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 MariyaFilippova/mcp-strava

使用说明

MCP Strava服务器

一个模型上下文协议(MCP)服务器,将Strava与Claude for Desktop集成在一起,可以对您的健身活动进行人工智能分析。

特性

  • ⭐ 路线生成 -使用谷歌地图链接建议往返路线(不需要API密钥)
  • ⭐ 热门航线 -发现附近的热门Strava路段,并在谷歌地图上循环浏览
  • OAuth身份验证 具有自动令牌刷新和持久性
  • 活动分析 -按ID获取任何活动的详细信息,或浏览最近的活动
  • 数据流 -心率、速度、高度、节奏、功率、任何活动的GPS
  • 搭接断裂 -每圈距离、时间、速度、海拔高度和心率
  • 个人最大努力 -跑步最快400公里、1公里、1英里、5公里、10公里等,包括配速和PR排名
  • 分页搜索 -按完整分页的日期范围查找活动
  • 历史比较 -同比比较月份
  • 统计 -历史统计数据、每周/每月摘要
  • 过滤 -按活动类型(跑步、骑行、游泳等)

可用工具

工具 说明
auth_strava 使用Strava授权(打开浏览器)
logout 清除存储的令牌以切换帐户
last_activity 获取您最近活动的详细信息
get_activity 按ID获取任何活动
recent_activities 列出最近10项活动
search_activities 带可选日期范围的分页搜索(before/after 时代, 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 任何活动的完整数据流(人力资源、速度、高度、节奏、功率、GPS等)
get_laps 任何活动的圈分(距离、时间、速度、高度、HR)
get_best_efforts 个人最佳跑步成绩(400米、1公里、1英里、5公里、10公里等),包括配速和PR排名
suggest_route 生成往返路线并获取谷歌地图链接进行导航
popular_routes 查找附近的热门Strava路段,并在其中构建谷歌地图路线

设置

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

编辑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。

使用示例

配置后,您可以向Claude询问以下问题:

  • “显示我最近的Strava活动”
  • “我的跑步记录是什么?”
  • “将我的2025年1月与2026年1月进行比较”
  • “给我总结一下我本周的自行车运动”
  • “我这个月的训练和上个月相比怎么样?”
  • “显示活动123456789的圈分”
  • “分析我上次跑步的心率和海拔数据”
  • “查找我自2025年3月以来的所有活动”
  • “建议从纽约市中央公园开始一条5公里的跑步路线”
  • “从48.8566、2.3522生成一条10公里的自行车道”
  • “查找纽约市中央公园附近的热门跑步路段”
  • “给我看看巴黎10公里范围内的热门自行车道”

认证

首次使用时,服务器将打开您的浏览器进行Strava授权。令牌被持久化 ~/.strava-mcp-token.json 并在过期时自动刷新。

使用 logout 如果您需要切换帐户,可以使用工具清除存储的令牌。

许可证

麻省理工学院