Strava MCP 服务器

此项目使用 TypeScript 实现了一个 Model Context Protocol (MCP) 服务器，作为与 Strava API 的桥梁。它将 Strava 数据和功能以“工具”的形式暴露出来，大型语言模型 (LLMs) 可以通过 MCP 标准来利用这些工具。

<a href="https://glama.ai/mcp/servers/@r-huijts/strava-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@r-huijts/strava-mcp/badge" alt="Strava 服务器 MCP 服务器" /> </a>

功能

• 🏃 访问最近的活动、个人资料和统计数据。
• 📊 获取详细的活动流（功率、心率、踏频等）。
• 🗺️ 探索、查看、收藏和管理路段。
• ⏱️ 查看详细的活动和路段努力信息。
• 📍 列出并查看保存路线的详细信息。
• 💾 将路线导出为 GPX 或 TCX 格式到本地文件系统。
• 🤖 通过 MCP 提供 AI 友好的 JSON 响应。
• 🔧 使用 Strava API V3。

自然语言交互示例

向您的 AI 助手提出以下问题，以与您的 Strava 数据进行互动：

最近的活动和个人资料：

• “显示我最近的 Strava 活动。”
• “我最近三次骑行是什么？”
• “获取我的 Strava 个人资料信息。”
• “我的 Strava 用户名是什么？”

活动流和数据：

• “获取昨天早上跑步的心率数据。”
• “显示我上次骑行的功率数据。”
• “周末世纪骑行时我的踏频是多少？”
• “获取上周四晚上锻炼的所有流数据。”
• “显示我攀登 Mt. Diablo 的海拔剖面。”

统计数据：

• “今年我在 Strava 上的跑步统计数据是什么？”
• “我总共骑了多少公里？”
• “显示我所有时间的游泳总里程。”

特定活动：

• “给我最后一次跑步的详细信息。”
• “周二间歇训练的平均功率是多少？”
• “我昨天通勤时是否使用了我的 Trek 自行车？”

俱乐部：

• “我在哪些 Strava 俱乐部里？”
• “列出我加入的俱乐部。”

路段：

• “列出我在科罗拉多州博尔德附近标记的路段。”
• “显示我最喜欢的路段。”
• “获取‘Alpe du Zwift’路段的详细信息。”
• “金门公园附近有没有好的跑步路段？”
• “在博尔德旗杆山附近找到具有挑战性的爬坡路段。”
• “为我标记‘Flagstaff Road Climb’路段。”
• “取消标记‘Lefthand Canyon’路段。”

路段努力：

• “显示我本月在‘Sunshine Canyon’路段的努力情况。”
• “列出我今年一月到六月在 Box Hill 路段的尝试。”
• “获取我在 Alpe d'Huez 个人记录的详细信息。”

路线：

• “列出我保存的 Strava 路线。”
• “显示我的路线的第二页。”
• “我的 Boulder Loop 路线的海拔增益是多少？”
• “获取我的‘Boulder Loop’路线的描述。”
• “将我的‘Boulder Loop’路线导出为 GPX 文件。”
• “将我周日早上的路线保存为 TCX 文件。”

高级提示示例

这是一个更高级的提示示例，用于创建您 Strava 活动的专业自行车教练分析：

You are Tom Verhaegen, elite cycling coach and mentor to world champion Mathieu van der Poel. Analyze my most recent Strava activity. Provide a thorough, data-driven assessment of the ride, combining both quantitative insights and textual interpretation.

Begin your report with a written summary that highlights key findings and context. Then, bring the raw numbers to life: build an interactive, visually striking dashboard using HTML, CSS, and JavaScript. Use bold, high-contrast colors and intuitive, insightful chart types that best suit each metric (e.g., heart rate, power, cadence, elevation).

Embed clear coaching feedback and personalized training recommendations directly within the visualization. These should be practical, actionable, and grounded solely in the data provided—no assumptions or fabrications.

As a bonus, sprinkle in motivational quotes and cheeky commentary from Mathieu van der Poel himself—he's been watching my rides with one eyebrow raised and a smirk of both concern and amusement.

Goal: Deliver a professional-grade performance analysis that looks and feels like it came straight from the inner circle of world-class cycling.

此提示将创建您最近一次 Strava 活动的个性化分析，包括专业教练反馈和自定义可视化仪表板。

⚠️ 重要设置步骤

为了成功与 Claude 集成，请严格按照以下顺序执行这些步骤：

1. 安装服务器及其依赖项
2. 在 Claude 的配置中配置服务器
3. 完成 Strava 认证流程
4. 重启 Claude 以确保正确加载环境变量

跳过步骤或不按顺序执行可能会导致 Claude 无法正确读取环境变量。

安装与设置

1. 先决条件：
   • Node.js（推荐 v18 或更高版本）
   • npm（通常随 Node.js 一起提供）
   • 一个 Strava 账户

1. 从源代码安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

2. 配置 Claude 桌面版

更新您的 Claude 配置文件：

{
  "mcpServers": {
    "strava-mcp-local": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/strava-mcp/dist/server.js"
      ]
      // Environment variables are read from the .env file by the server
    }
  }
}

请确保将 /absolute/path/to/your/strava-mcp/ 替换为实际的安装路径。

3. Strava 认证设置

setup-auth.ts 脚本简化了与 Strava API 的认证设置。请仔细按照以下步骤操作：

创建 Strava API 应用程序

1. 前往 https://www.strava.com/settings/api
2. 创建一个新的应用程序：
   • 输入您的应用程序详细信息（名称、网站、描述）
   • 重要：将“授权回调域名”设置为 localhost
   • 记下您的客户端 ID 和客户端密钥

运行设置脚本

# In your strava-mcp directory
npx tsx scripts/setup-auth.ts

根据提示完成认证流程（详细说明见下方的认证部分）。

4. 重启 Claude

完成上述所有步骤后，重启 Claude 桌面版以使更改生效。这可以确保：

• 加载新的配置
• 正确读取环境变量
• 正确初始化 Strava MCP 服务器

🔑 环境变量

令牌处理

该服务器实现了自动刷新令牌的功能。当初始访问令牌过期（通常为 6 小时后），服务器将自动使用存储在 .env 中的刷新令牌获取新的访问令牌和刷新令牌。这些新令牌随后会在运行中的进程和 .env 文件中更新，确保持续运行。

你只需要运行一次 scripts/setup-auth.ts 脚本来进行初始设置。

配置导出路径（可选）

如果你打算使用 export-route-gpx 或 export-route-tcx 工具，你需要指定一个目录来保存导出的文件。

编辑你的 .env 文件，并添加/更新 ROUTE_EXPORT_PATH 变量：

# Optional: Define an *absolute* path for saving exported route files (GPX/TCX)
# Ensure this directory exists and the server process has write permissions.
# Example: ROUTE_EXPORT_PATH=/Users/your_username/strava-exports
ROUTE_EXPORT_PATH=

将占位符替换为你希望的导出目录的绝对路径。确保该目录存在并且服务器有权限写入该目录。

API 参考

服务器公开了以下 MCP 工具：

---

get-recent-activities

获取已认证用户的最近活动。

• 何时使用： 当用户询问他们的最近锻炼、活动、跑步、骑行等时。
• 参数：
  • perPage（可选）:
    • 类型: number
    • 描述: 要检索的活动数量。
    • 默认值: 30
• 输出： 最近活动的格式化文本列表（名称、ID、距离、日期）。
• 错误： 缺失/无效令牌、Strava API 错误。

---

get-athlete-profile

获取已认证运动员的个人资料信息。

• 何时使用： 当用户询问他们的个人资料详情、用户名、位置、体重、是否为高级会员等时。
• 参数： 无
• 输出： 包含个人资料详情的格式化文本字符串。
• 错误： 缺失/无效令牌、Strava API 错误。

---

get-athlete-stats

获取已认证运动员的活动统计数据（最近、年度至今、历史总计）。

• 何时使用： 当用户询问他们的总体统计数据、跑步/骑行/游泳总数、个人记录（最长骑行、最大爬升）等时。
• 参数： 无
• 输出： 根据用户测量偏好格式化的统计数据摘要文本。
• 错误： 缺失/无效令牌、Strava API 错误。

---

get-activity-details

通过其 ID 获取特定活动的详细信息。

• 何时使用： 当用户询问由其 ID 确定的特定活动的详细信息时。
• 参数：
  • activityId（必需）:
    • 类型: number
    • 描述: 活动的唯一标识符。
• 输出： 根据用户测量偏好格式化的包含详细活动信息（类型、日期、距离、时间、速度、心率、功率、装备等）的文本字符串。
• 错误： 缺失/无效令牌、无效的 activityId、Strava API 错误。

---

list-athlete-clubs

列出已认证运动员所属的俱乐部。

• 何时使用： 当用户询问他们加入的俱乐部时。
• 参数：…