Strava MCP 服务器

Python 包许可证：MIT Python 3.10

提供对 Strava API 访问权限的模型上下文协议(MCP) 服务器。它允许语言模型从 Strava API 查询运动员活动数据。

可用工具

该服务器公开以下工具：

活动查询

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

日期应采用 ISO 格式 ( YYYY-MM-DD )。

Related MCP server: Whoop MCP Server

活动数据格式

服务器返回具有一致字段名称和单位的活动数据：

场地	描述	单元
`name`	活动名称	-
`sport_type`	运动类型	-
`start_date`	开始日期和时间	ISO 8601
`distance_metres`	距离	米
`elapsed_time_seconds`	总耗时	秒
`moving_time_seconds`	搬家时间	秒
`average_speed_mps`	平均速度	米/秒
`max_speed_mps`	最大速度	米/秒
`total_elevation_gain_metres`	总海拔增益	米
`elev_high_metres`	最高海拔	米
`elev_low_metres`	最低海拔	米
`calories`	消耗的卡路里	千卡
`start_latlng`	起始坐标	[纬度，经度]
`end_latlng`	结束坐标	[纬度，经度]

验证

要使用此服务器，您需要通过 Strava API 进行身份验证。请按以下步骤操作：

创建 Strava API 应用程序：
- 前往Strava API 设置
- 创建应用程序以获取您的客户端 ID 和客户端密钥
- 将授权回调域设置为localhost
获取您的刷新令牌：
- 使用包含的get_strava_token.py脚本：GXP1
- 按照提示授权您的应用程序
- 该脚本将把你的令牌保存到.env文件中
设置环境变量：服务器需要以下环境变量：
- STRAVA_CLIENT_ID ：您的 Strava API 客户端 ID
- STRAVA_CLIENT_SECRET ：您的 Strava API 客户端密钥
- STRAVA_REFRESH_TOKEN ：您的 Strava API 刷新令牌

用法

克劳德桌面版

更新您的claude_desktop_config.json （在 macOS 上位于~/Library/Application\ Support/Claude/claude_desktop_config.json ，在 Windows 上位于%APPDATA%/Claude/claude_desktop_config.json ）以包含以下内容：

{ "mcpServers": { "strava": { "command": "uvx", "args": [ "strava-mcp-server" ], "env": { "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID", "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN" } } } }