Strava MCP Server

Strava MCP 服务

一个 Model Context Protocol (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 进行身份验证。请按照以下步骤操作：

1. 创建一个 Strava API 应用：

   • 前往 Strava API Settings
   • 创建一个应用以获取你的 Client ID 和 Client Secret
   • 将 Authorization Callback Domain 设置为 localhost

2. 获取你的 refresh token：

   • 使用附带的 get_strava_token.py 脚本：

   python get_strava_token.py
   

   • 按照提示授权你的应用
   • 该脚本会将你的 token 保存到 .env 文件

3. 设置环境变量： 该服务需要以下环境变量：

   • STRAVA_CLIENT_ID：你的 Strava API Client ID
   • STRAVA_CLIENT_SECRET：你的 Strava API Client Secret
   • STRAVA_REFRESH_TOKEN：你的 Strava API Refresh Token

使用方法

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"
            }
        }
    }
}

Claude Web

对于 Claude Web，你可以在本地运行该服务，并使用 MCP 扩展进行连接。

示例查询

连接后，你可以向 Claude 提出如下问题：

• “我最近有哪些活动？”
• “显示我上周的活动”
• “过去一个月我最长的一次跑步是什么？”
• “获取我最近一次骑行活动的详细信息”

错误处理

该服务针对常见问题提供人类可读的错误消息：

• 日期格式无效
• API 身份验证错误
• 网络连接问题

许可证

本项目采用 MIT 许可证授权 — 详情请参阅 LICENSE 文件。