Strava MCP Server

Strava MCP Server

site icon
2025.03.11 0
JavaScript运动数据管理API 集成位置服务
Strava MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Strava API 交互,允许 Claude 访问和操作用户的 Strava 数据。该服务器提供了获取活动信息、创建活动、查看点赞者等功能,适用于运动数据管理和分析场景。
View on GitHub

Overview

基本能力

产品定位

Strava MCP Server 是一个中间件服务,用于连接 Claude 和 Strava API,实现运动数据的查询和管理。

核心功能

  • 获取认证运动员的活动列表 (get_athlete_activities)
  • 获取特定活动的详细信息 (get_activity)
  • 创建手动活动 (create_activity)
  • 获取活动点赞者列表 (get_activity_kudoers)
  • 获取活动圈数信息 (get_activity_laps)

适用场景

  • 运动数据分析
  • 个人运动记录管理
  • 运动社交互动

工具列表

  1. get_athlete_activities: 获取认证运动员的活动列表
  2. get_activity: 获取特定活动的详细信息
  3. create_activity: 创建手动活动
  4. get_activity_kudoers: 获取活动点赞者列表
  5. get_activity_laps: 获取活动圈数信息

常见问题解答

  • 认证错误: 刷新令牌可能已过期,需重新运行 get-strava-token.js 脚本获取新令牌
  • 服务器无法启动: 检查 MCP 设置文件中的路径是否正确,并确保已运行 npm run build
  • API 速率限制: Strava API 有速率限制,遇到错误时请等待几分钟后重试

使用教程

使用依赖

  1. 安装 Node.js 环境
  2. 进入项目目录:
cd /Users/{USERNAME}/Documents/Cline/MCP/strava-mcp-server
  1. 安装依赖:
npm install

安装教程

  1. 创建 Strava API 应用并获取 Client ID 和 Client Secret
  2. 获取刷新令牌:
node get-strava-token.js YOUR_CLIENT_ID YOUR_CLIENT_SECRET
  1. 配置 MCP 设置文件,添加 API 凭证
  2. 构建并启动服务器:
npm run build
npm start

调试方式

  1. 检查服务器是否正常运行
  2. 测试 API 调用:
# 示例命令
curl -X GET "http://localhost:3000/api/activities"
  1. 查看日志输出排查问题

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。