Strava MCP Server

Strava MCP Server

site icon
2025.04.21 0
Python运动数据分析API 中间件位置服务
Strava MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 Strava API 的访问。它允许语言模型查询来自 Strava API 的运动员活动数据。该服务器主要用于获取和查询运动员的活动信息,包括活动名称、运动类型、距离、时间、速度、海拔等详细数据。
View on GitHub

Overview

基本能力

产品定位

Strava MCP Server 是一个用于访问 Strava API 的中间件服务,主要用于查询和管理运动员的活动数据。

核心功能

  • 获取运动员的近期活动
  • 按日期范围查询活动
  • 获取特定活动的详细信息
  • 获取过去X天的活动

适用场景

  • 运动员活动数据分析
  • 运动表现跟踪
  • 个人健康管理
  • 运动数据可视化

工具列表

  1. get_activities(limit: int = 10): 获取认证运动员的近期活动
  2. get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30): 获取特定日期范围内的活动
  3. get_activity_by_id(activity_id: int): 获取特定活动的详细信息
  4. get_recent_activities(days: int = 7, limit: int = 10): 获取过去X天的活动

常见问题解答

  • 日期格式应为 ISO 格式 (YYYY-MM-DD)
  • 需要正确的 Strava API 认证
  • 网络连接问题可能导致查询失败

使用教程

使用依赖

  1. Python 3.10
  2. Strava API 应用 (需要 Client ID 和 Client Secret)

安装教程

  1. 创建 Strava API 应用:
  2. 访问 Strava API Settings
  3. 创建应用以获取 Client ID 和 Client Secret
  4. 设置 Authorization Callback Domain 为 localhost

  5. 获取 refresh token: bash python get_strava_token.py 按照提示授权您的应用,脚本会将 token 保存到 .env 文件

  6. 设置环境变量:

  7. STRAVA_CLIENT_ID: 您的 Strava API Client ID
  8. STRAVA_CLIENT_SECRET: 您的 Strava API Client Secret
  9. STRAVA_REFRESH_TOKEN: 您的 Strava API Refresh Token

调试方式

  1. 确保环境变量已正确设置
  2. 检查网络连接
  3. 验证日期格式是否正确
  4. 检查 API 认证是否有效

许可证

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