Strava MCP Server

Strava MCP Server

site icon
2025.02.28 8
Python运动数据分析API集成位置服务
Strava MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 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认证
  • 网络连接问题可能导致API调用失败

使用教程

使用依赖

  1. Python 3.10
  2. Strava API 账号

安装教程

  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

  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. 验证API认证是否成功
  3. 检查网络连接是否正常
  4. 确保日期格式正确

许可证

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