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 文件。