strava-mcp

Strava MCP 服务

通过 AI 与你的 Strava 数据对话。

将 Claude 连接到你的 Strava 账号，并用日常语言提问：“我这个月跑了多远？”，“分析我最近一次骑行”，或“显示我速度最快的路段。”

你可以用它做什么？

连接后，只需像和一位能够访问你所有 Strava 数据的朋友聊天一样与 Claude 对话：

🏃 跟踪进度

“我这个月跑了多少公里？”

“比较我从 1 月到 12 月的跑步数据”

“我有史以来最长的一次骑行是什么？”

📊 分析训练

“详细分析我最近一次骑行训练——显示功率、心率和踏频”

“我昨天跑步时的心率区间怎么样？”

“我间歇训练每一圈的平均配速是多少？”

🗺️ 探索路线和路段

“中央公园附近最受欢迎的骑行路段有哪些？”

“显示我收藏的路段”

“将我的周日早晨路线导出为 GPX 文件”

🏆 获取训练建议

“分析我本周的训练负荷”

“我目前的体能状况与上个月相比如何？”

“总结我今年的骑行表现”

快速开始（3 步）

第 1 步：添加到 Claude Desktop

打开你的 Claude Desktop 配置文件：

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

将以下内容添加到文件中：

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "@r-huijts/strava-mcp-server"]
    }
  }
}

第 1 步（替代方案）：添加到 Claude Code

你可以使用以下命令将此 MCP 服务添加到 Claude Code：

claude mcp add --transport stdio strava -- npx @r-huijts/strava-mcp-server

你可以按如下方式确认安装成功：

% claude mcp list
Checking MCP server health...

strava: npx @r-huijts/strava-mcp-server - ✓ Connected

第 2 步：重启 Claude Desktop

关闭并重新打开 Claude Desktop，以加载新配置。

第 3 步：连接你的 Strava

只需对 Claude 说：

“连接我的 Strava 账号”

浏览器窗口将会打开。输入你的 Strava API 凭据，授权此应用，即可完成！

就是这么简单！ 开始询问你的活动情况吧。

连接你的 Strava 账号

首次设置

当你说“连接我的 Strava 账号”时，会发生以下情况：

1. 浏览器窗口打开，显示设置页面
2. 输入你的 Strava API 凭据（Client ID 和 Client Secret）
3. 点击“Continue to Strava”——你将被重定向到 Strava
4. 在 Strava 网站上授权此应用
5. 看到成功消息——你可以关闭浏览器
6. 完成！ Claude 会确认你已连接

你的凭据会保存在本地的 ~/.config/strava-mcp/config.json 中，并在不同会话间保留。

获取 Strava API 凭据

你需要创建一个免费的 Strava API 应用（只需设置一次）：

1. 前往 strava.com/settings/api
2. 点击“Create an App”（或查看你现有的应用）
3. 填写表单：
   • 应用名称：任意填写（例如，“My Claude Assistant”）
   • 类别：任选
   • 网站：可填写任意内容（例如，http://localhost）
   • 授权回调域名：必须是 localhost
4. 复制你的 Client ID 和 Client Secret

就是这么简单！你只需要设置一次。

管理连接

• 检查状态：“我已连接到 Strava 吗？”
• 重新连接：“连接我的 Strava 账号”（使用 force: true 重新连接）
• 断开连接：“断开我的 Strava 账号连接”

安装选项

选项 A：直接使用（推荐）

无需安装！快速开始中的 npx 命令会自动下载并运行最新版本。

选项 B：全局安装

如果你更喜欢只安装一次：

npm install -g @r-huijts/strava-mcp-server

然后更新 Claude 配置以使用：

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp-server"
    }
  }
}

注意： 虽然包名是 @r-huijts/strava-mcp-server，但为保持向后兼容，可执行文件名称仍为 strava-mcp-server。

选项 C：从源代码构建

适合希望修改代码的开发者：

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

然后将 Claude 指向你的本地构建：

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/path/to/strava-mcp/dist/server.js"]
    }
  }
}

对话示例

早间签到

你：我这周做了哪些运动？

Claude：查看你本周的 Strava 活动，你完成了：

• 周一：5.2km 跑步（28:15）
• 周三：45km 骑行（1:32:00）
• 周六：10km 跑步（52:30）

总计：3 项活动，共 60.2km。坚持得不错！

训练分析

你：详细分析我最近一次骑行训练

Claude：以下是你昨天「晚间环线」骑行的详细分析：

概览

• 距离：42.3 km
• 时间：1:28:45
• 平均速度：28.6 km/h

功率分析

• 平均功率：185W
• 标准化功率：198W
• 最大功率：520W

心率

• 平均：142 bpm
• 最大：175 bpm
• 4 区及以上时长：23 分钟

你的功率与心率比值表明有不错的有氧效率……

查找新路线

你：帮我找一些科罗拉多州博尔德附近有挑战性的骑行爬坡路线

Claude：以下是博尔德附近热门的爬坡路段：

1. Flagstaff Road - 5.2km，平均坡度 6.8%
2. Sunshine Canyon - 3.8km，平均坡度 7.2%
3. Left Hand Canyon - 8.1km，平均坡度 4.5%

需要我把其中哪些标为星标，方便你以后查找吗？

可用工具

账户与个人资料

活动

统计与进度

路段

路线

俱乐部

训练

服务

故障排除

“连接我的 Strava 账户”没有打开浏览器

• 确保 Claude Desktop 正在运行 MCP 服务（检查 Claude 中是否有错误）
• 尝试重启 Claude Desktop
• 检查端口 8111 是否被防火墙阻止

“身份验证失败”或“令牌无效”

• 你的令牌可能已过期——说“连接我的 Strava 账户”以重新连接
• 确保你的 Strava API 应用仍在 strava.com/settings/api 上处于活动状态

“缺少凭据”错误

• 你需要完成 OAuth 流程——说“连接我的 Strava 账户”
• 如果你使用环境变量，请确保 4 个变量都已设置（参见“开发者”部分）

Claude 看不到 Strava 工具

• 确保你的 claude_desktop_config.json 是有效的 JSON（末尾不能有逗号！）
• 修改配置后重启 Claude Desktop
• 检查 Claude 的开发者控制台中是否有错误消息

更改包名后出现 JSONRPC.ProtocolTransportError

如果更新到 @r-huijts/strava-mcp-server 后出现 JSONRPC 错误：

1. 清除 npx 缓存：在终端中运行 rm -rf ~/.npm/_npx
2. 验证配置是否使用 @r-huijts/strava-mcp-server（而不是旧的 strava-mcp-server）
3. 彻底重启 Claude Desktop（退出并重新打开）
4. 手动测试：运行 npx -y @r-huijts/strava-mcp-server——你应该会看到“Starting Strava MCP Server v1.2.1...”

开发者

npm install
npm run build
npm test

许可证

MIT 许可证——详情请参阅 LICENSE 文件。

有问题？ 请在 GitHub 上提交 issue。