Strava Mcp Unofficial

Strava MCP

让你的 AI Agent 在本地访问 Strava 活动、数据流、路段和路线 —。
本地优先的 MCP 服务 — 令牌永远不会离开你的设备。

⚡ 使用 Delx Wellness for Hermes 一键安装： npx -y delx-wellness-hermes setup — 在专用的 Hermes 配置中预先配置此连接器及其他 8 个连接器。

或者将其独立接入 Claude Desktop / Cursor / ChatGPT Desktop — 请参阅下方的安装部分。

---

HTTP（v2 无状态）

默认使用 stdio。可选 Streamable HTTP — 无会话 ID，返回 JSON 响应，仅限环回连接：

npx -y strava-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

环境变量：STRAVA_MCP_HOST、STRAVA_MCP_PORT、STRAVA_MCP_TRANSPORT=http。

本地优先的 MCP 服务，可将 AI Agent 连接到你的 Strava 活动、路线、数据流和训练背景信息。

非官方项目。 与 Strava, Inc. 无关联，也未获其认可或支持。Strava 是其各自所有者的商标。请仅将此项目用于你自己的 Strava 账户，并遵守 Strava 的 API 协议。

由 David Mosiah 为使用 Claude、Cursor、Hermes、OpenClaw 或其他兼容 MCP 的 Agent 来思考训练、耐力和表现的人打造——无需从 Strava 复制粘贴数据。

这是 Delx Wellness 的一部分；Delx Wellness 是本地优先的健康类 MCP 连接器目录。

如果此连接器对你的 Agent 工作流有所帮助，请为此仓库点个星。星标能让其他 AI 开发者更容易发现这个项目，也能帮助 Delx 持续推出本地优先的健康基础设施。

为什么需要它

Strava 留存着你训练的长期记录——每一次骑行、跑步、游泳、路段、路线和数据流。但这些数据藏在 OAuth API 后面，且有严格的速率限制（每个应用每 15 分钟 200 次请求、每天 2,000 次），GPS 数据默认具有隐私敏感性。

这个软件包会在本地完成 OAuth 授权流程，在 Strava 的每个应用速率限制下控制请求频率，除非你明确选择启用，否则会隐藏 GPS 纬度和经度，并通过模型上下文协议提供 Strava 数据。任何兼容 MCP 的 Agent 只需一段配置，就能获取你的训练上下文。令牌绝不会离开你的设备。

快速开始

大约一分钟，就能从零开始发出第一次 Agent 调用。你只需要一个 Strava 应用（在此创建），并将重定向 URI 设为 http://127.0.0.1:3000/callback。

1. 输入应用的客户端 ID 和密钥（交互式操作，保存到 ~/.strava-mcp/config.json，权限为 0600）：

npx -y strava-mcp-unofficial setup

2. 授权 Strava。 auth 会打开浏览器；--no-open 会打印 URL，方便你自行粘贴（适用于无头设备）。令牌会保存在本地——命令绝不会打印令牌：

$ npx -y strava-mcp-unofficial auth --no-open
Strava MCP · Authorization

Open this URL manually:
  https://www.strava.com/oauth/authorize?client_id=12345&redirect_uri=http%3A%2F%2F127.0.0.1%3A3000%2Fcallback&response_type=code&approval_prompt=auto&scope=read%2Cactivity%3Aread_all%2Cprofile%3Aread_all&state=aa38f29b

Steps
  1. Approve access in the browser tab that opens.
  2. Strava will redirect to the local callback.
  3. Tokens are saved locally; this command never prints them.

Waiting for callback...

3. 确认已准备就绪——doctor 会确认权限范围和配置，但不会调用 Strava：

$ npx -y strava-mcp-unofficial doctor
Strava MCP · Doctor
Status: READY ✓

Checks
  ✓  Node.js >=20
  ✓  Env vars
  ✓  Local config
  ✓  Automatic auth redirect
  ✓  Token file
  ✓  Token permissions
  ✓  Refresh token
  ✓  OAuth scopes
  ·  Privacy mode
  ·  Cache

Next steps
  1. Ready. Add this MCP server to your agent and start with strava_daily_summary.

如果 OAuth scopes 显示 ✗，请重新运行 auth，并批准 activity:read_all profile:read_all read。

4. 首次调用——无需真实账户。 请 Agent 运行 strava_demo。它会返回逼真的模拟数据（标记为 is_demo: true），这样你就能在连接真实数据前配置好提示词：

> Call strava_demo and summarize my week.

# Strava Demo

- **is_demo**: true
- **recent_sessions**: 3
- **load_classification**: moderate
- **primary_signal**: Recent Strava load is manageable; use intent and consistency as the main lever.
- **recommended_handoff**: exercise_catalog_recommend_session

使用 response_format: "json" 调用，即可获取完整的数据结构。sample 块中的字段与 strava_daily_summary、strava_training_context 和 strava_list_activities 一一对应——npm run test:demo-contract 会使用 fixtures/strava-activities.mjs 运行实际构建器；如果模拟数据虚构或遗漏字段，构建就会失败。将 strava_demo 换成真实工具，就会以相同的数据结构填入你的 Strava 数据。

5. 将其接入 MCP 客户端：

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "strava-mcp-unofficial"]
    }
  }
}

对于 Claude Desktop，运行 setup --client claude，即可自动生成配置片段。Hermes 的配置方法请参阅下文的 Hermes / 远程配置。

与 Agent 一起试用

可以先问这三个问题：

Use strava_connection_status to check setup, then run strava_daily_summary.
Tell me what my training context looks like in 5 lines.

Call strava_weekly_summary with response_format=json. Find my biggest
load/intensity bottleneck and give me a next-week endurance plan.

Use the strava_activity_stream_investigator prompt for activity_id=<id>.
Don't expose GPS unless I explicitly ask for it.

数据可用性

此软件包使用官方 Strava API v3。本 README 中的 raw 指受支持端点返回的 Strava 上游 JSON 数据，而非连续的设备遥测数据。

数据	可用性	备注
活动（跑步、骑行、游泳、步行、训练）	✓	所有记录的活动
活动详情 + 区间 + 分段	✓	心率、功率、踏频、海拔、装备
活动数据流（心率 / 踏频 / 瓦特 / 海拔）	✓	活动期间每秒采样数据
GPS 纬度/经度数据流	需启用	默认隐藏；需要 include_gps=true 或 raw 模式
运动员资料 + 区间 + 汇总统计	✓	已认证的运动员
路线 + 俱乐部 + 装备	✓	在摘要/结构化模式下会隐藏路线几何数据
实时设备遥测数据 / 连续心率	—	Strava 的公共 API 不提供

工具

从这些工具开始：

• strava_connection_status — 在调用 Strava 前验证本地设置、权限范围和就绪状态
• strava_data_inventory — 列出支持的数据领域、权限范围、隐私模式和建议的首次调用，不调用 Strava API。
• strava_daily_summary — 今日最新活动、每周负荷和强度背景
• strava_weekly_summary — 评分卡、与上周的比较及下周训练计划

身份验证与诊断

• strava_capabilities、strava_agent_manifest、strava_privacy_audit、strava_cache_status
• strava_get_auth_url、strava_exchange_code、strava_revoke_access

运动员与训练

• strava_get_athlete、strava_get_zones、strava_get_athlete_stats

活动与数据流

• strava_list_activities、strava_get_activity、strava_get_activity_zones
• strava_activity_series、strava_get_activity_streams — GPS 经纬度需要设置 include_gps=true 或使用 raw 模式

路线与背景信息

• strava_list_routes、strava_get_route、strava_list_clubs、strava_get_gear

提示词

• strava_daily_training_director — 实用的每日训练简报
• strava_weekly_endurance_review — 每周比较及下周耐力训练计划
• strava_activity_stream_investigator — 使用数据流调查一项活动（支持 GPS）

每项提示词都接受 timezone（IANA，默认值为 UTC）。

资源

• strava://capabilities、strava://agent-manifest
• strava://athlete
• strava://latest/activity
• strava://summary/daily、strava://summary/weekly

隐私与安全

• OAuth 令牌存储在 ~/.strava-mcp/tokens.json 中，权限为 0600，工具绝不会返回令牌。
• 默认不请求写入/上传权限范围——按设计仅支持读取。
• 在 summary 和 structured 模式下，会递归移除 GPS 经纬度和路线几何数据；只有在数据流调用中明确设置 include_gps=true 或使用 raw 模式时才会包含这些数据。
• 除此之外，结构化模式会保留完整的上游生理记录和 Strava 未来新增的字段。
• 将带时区的 ISO 日期时间转换为 Strava epoch 秒时，活动的 after / before 筛选条件会保留时间点语义；无效范围会在发送 HTTP 请求前报错。
• 除非明确请求使用 raw 模式，否则也会对路线几何数据进行脱敏。
• MCP 客户端无法看到访问令牌或刷新令牌。
• 这不是医疗建议。该服务提供用户授权的数据，用于个人 AI 工作流，而非诊断或训练处方。

配置

setup 会将其中大多数配置写入 ~/.strava-mcp/config.json（0600）。支持手动通过环境变量覆盖：

STRAVA_CLIENT_ID=…
STRAVA_CLIENT_SECRET=…
STRAVA_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
STRAVA_SCOPES="read activity:read_all profile:read_all"
STRAVA_PRIVACY_MODE=structured        # summary | structured | raw
STRAVA_CACHE=sqlite                   # optional read-through cache

Hermes / 远程设置

npx -y strava-mcp-unofficial setup --client hermes --no-auth
npx -y strava-mcp-unofficial auth                       # run locally if browser auth is needed
npx -y strava-mcp-unofficial doctor --client hermes
hermes mcp test strava

Hermes 通常会为 Strava 工具添加前缀：

• mcp_strava_strava_agent_manifest
• mcp_strava_strava_connection_status
• mcp_strava_strava_daily_summary
• mcp_strava_strava_weekly_summary
• mcp_strava_strava_get_activity_streams

更改 Hermes 配置后，使用 /reload-mcp 或 hermes mcp test strava。常规数据访问无需重启网关。

如果浏览器 OAuth 必须在与 Hermes 不同的机器上进行，请在本地运行 auth，然后将 ~/.strava-mcp/tokens.json 复制到服务器，并执行 chmod 600。若要访问活动历史和数据流，令牌必须包含 activity:read_all profile:read_all read。

要求

• Node.js 20+
• 一个重定向 URI 为 http://127.0.0.1:3000/callback 的 Strava 应用

选择这些权限范围的原因：

• read — 公开个人资料、路线和 Strava 公开资源
• activity:read_all — 你的活动，包括应用可见的私密活动
• profile:read_all — 更完整的已验证运动员个人资料字段

默认不请求任何写入权限范围。

开发

git clone https://github.com/davidmosiah/strava-mcp.git
cd strava-mcp
npm install
npm test
npm run build

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector node dist/index.js

链接

• npm：https://www.npmjs.com/package/strava-mcp-unofficial
• 文档网站：https://wellness.delx.ai/connectors/strava
• 旧版文档：https://stravamcp.vercel.app/
• GitHub Pages 镜像：https://davidmosiah.github.io/strava-mcp/
• Delx Wellness 注册表：https://github.com/davidmosiah/delx-wellness
• 连接器质量标准：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
• Strava API 文档：https://developers.strava.com/docs/reference/
• Strava 身份验证文档：https://developers.strava.com/docs/authentication/

另请参阅

完整的 Delx Wellness 连接器库：

提供商	软件包	仓库
WHOOP	whoop-mcp-unofficial	whoop-mcp
Oura	oura-mcp-unofficial	ouramcp
Garmin	garmin-mcp-unofficial	garminmcp
Strava	strava-mcp-unofficial	strava-mcp
Fitbit	fitbit-mcp-unofficial	fitbitmcp
Withings	withings-mcp-unofficial	withingsmcp
Apple Health	apple-health-mcp-unofficial	apple-health-mcp
Polar	polar-mcp-unofficial	polarmcp
Nourish（营养）	wellness-nourish	wellness-nourish

Hermes 一键设置 — 预配置上述所有连接器，以及健康技能和入门引导：delx-wellness-hermes。

📧 联系与支持

• 📨 [email protected] — 一般问题、集成帮助、合作事宜
• 🐛 错误报告 / 功能请求 — GitHub Issues
• 🐦 更新 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 详见 LICENSE。

免责声明

本软件按原样提供。它不是医疗器械，不提供医疗建议，也不应用于诊断、治疗或训练方案制定。如有医疗或训练方面的疑虑，请务必咨询合格的专业人士。

Skill 或 MCP

同一个软件包，两种使用方式。MCP 通过 stdio/HTTP 注册工具。Skill 可在客户端不支持 MCP 时，通过 CLI 调用相同的工具：

npx -y strava-mcp-unofficial call strava_connection_status --json '{}'

将 skill/SKILL.md 复制到你的 Agent 技能目录。