Strava MCP 服务器

提供对 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 )。

活动数据格式

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

验证

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

1. 创建 Strava API 应用程序：

   • 前往Strava API 设置

   • 创建应用程序以获取您的客户端 ID 和客户端密钥

   • 将授权回调域设置为localhost

2. 获取您的刷新令牌：

   • 使用包含的get_strava_token.py脚本：GXP1

   • 按照提示授权您的应用程序

   • 该脚本将把你的令牌保存到.env文件中

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

   • 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 ）以包含以下内容：

克劳德·韦伯

对于 Claude Web，您可以在本地运行服务器并使用 MCP 扩展连接它。

示例查询

连接后，您可以向 Claude 询问以下问题：

• “我最近有什么活动？”

• “显示我上周的活动”

• “过去一个月我跑的最长距离是多少？”

• “获取我最近的骑行活动详情”

错误处理

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

• 无效的日期格式

• API 身份验证错误

• 网络连接问题

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。