MCP 服务器

Strava MCP Server

一个模型上下文协议服务器，为语言模型提供访问 Strava API 数据的能力，使其能够查询和分析来自 Strava 的运动员活动数据。

Tools

get_activities

Get the authenticated athlete's recent activities. Args: limit: Maximum number of activities to return (default: 10) Returns: Dictionary containing activities data

get_activities_by_date_range

Get activities within a specific date range. Args: start_date: Start date in ISO format (YYYY-MM-DD) end_date: End date in ISO format (YYYY-MM-DD) limit: Maximum number of activities to return (default: 30) Returns: Dictionary containing activities data

get_activity_by_id

Get detailed information about a specific activity. Args: activity_id: ID of the activity to retrieve Returns: Dictionary containing activity details

get_recent_activities

Get activities from the past X days. Args: days: Number of days to look back (default: 7) limit: Maximum number of activities to return (default: 10) Returns: Dictionary containing activities data

README

Strava MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 Strava API 的访问。它允许语言模型查询来自 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)。

活动数据格式

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

字段	描述	单位
`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 脚本：
```
python get_strava_token.py
```
- 按照提示授权您的应用程序
- 该脚本会将您的令牌保存到 .env 文件
设置环境变量：服务器需要以下环境变量：
- STRAVA_CLIENT_ID: 您的 Strava API 客户端 ID
- STRAVA_CLIENT_SECRET: 您的 Strava API 客户端密钥
- STRAVA_REFRESH_TOKEN: 您的 Strava API 刷新令牌

用法

Claude for Desktop

更新您的 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"
            }
        }
    }
}