Strava MCP 服务器

一个提供对 Strava API 访问的 Model Context Protocol (MCP) 服务器。它允许语言模型查询 authenticated 选手的活动数据。

可用工具

该服务器暴露了以下工具：

活动查询

• get_activities(limit: int = 10)：获取 authenticated 运动员最近的活动
• 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 设置
   • 创建一个应用以获取您的 Client ID 和 Client Secret
   • 将授权回调域设置为 localhost

2. 获取您的 refresh token：

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

     python get_strava_token.py
     

   • 按照提示输入您的 Strava 凭证以获取 refresh token

3. 设置环境变量：

   • 将以下内容添加到 .env 文件或相应配置文件中：

     STRAVA_REFRESH_TOKEN=your_refresh_token_here
     

配置 MCP 服务器

根据您使用的语言模型（Claude Desktop 或 Web），按照以下步骤进行配置：

Claude Desktop

1. 打开 ~/.config/anthropic/claude/settings.json
2. 在 "mcp" 下添加 Strava 插件：

   "plugins": {
     "strava": {
       "enabled": true,
       "api_key": "your_api_key",
       "refresh_token": "your_refresh_token"
     }
   }
   

3. 保存文件并重启 Claude

Claude Web

1. 访问 Claude Web
2. 进入设置页面
3. 在 MCP 部分添加 Strava 插件：
   • API 密钥：your_api_key
   • Refresh Token：your_refresh_token

示例查询

以下是一些示例查询，帮助您快速上手：

查询最近活动

print(strava.get_recent_activities())

获取特定活动详细信息

activity_id = 123456789
print(strava.get_activity_by_id(activity_id))

注意事项

• 确保您的 API 密钥和 refresh token 安全，避免泄露。
• 定期更新 refresh token，以防止过期。
• 处理错误时，请参考文档中的错误处理部分。

通过以上步骤，您可以轻松将 Strava 数据集成到语言模型中，扩展其功能。