Strava MCP Server

Strava MCP 服务

这是一个用于 Strava API 的模型上下文协议（MCP）服务，可让 Claude 与您的 Strava 数据进行交互。

功能

Strava MCP 服务提供以下工具：

• get_athlete_activities：获取已验证运动员的活动
• get_activity：获取特定活动的详细信息
• create_activity：创建手动活动
• get_activity_kudoers：获取为某项活动送出 kudos 的运动员
• get_activity_laps：获取某项活动的圈数

设置说明

1. 创建 Strava API 应用

1. 前往 Strava API 设置
2. 创建新应用：
   • 应用名称：Claude Strava Integration（或您喜欢的任意名称）
   • 网站：http://localhost
   • 授权回调域名：localhost
3. 创建应用后，记下您的 Client ID 和 Client Secret

2. 获取刷新令牌

1. 安装所需依赖项：

   cd /Users/{USERNAME}/Documents/Cline/MCP/strava-mcp-server
   npm install
   

2. 使用您的 Client ID 和 Client Secret 运行 get-strava-token.js 脚本：

node get-strava-token.js YOUR_CLIENT_ID YOUR_CLIENT_SECRET

3. 脚本会打开浏览器窗口，要求您授权该应用访问您的 Strava 数据。
4. 授权后，脚本会在终端中显示您的刷新令牌。

3. 配置 MCP 设置

1. 更新 MCP 设置文件，填入您的 Strava API 凭据：
   • 位置：/Users/{USERNAME}/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • 在 strava 服务配置的 env 部分添加您的 Client ID、Client Secret 和刷新令牌：

     "strava": {
       "command": "node",
       "args": [
         "/Users/{USERNAME}/Documents/Cline/MCP/strava-mcp-server/dist/index.js"
       ],
       "env": {
         "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID",
         "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
         "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
       },
       "disabled": false,
       "autoApprove": []
     }
     

4. 构建并启动服务

需要时，Claude 会自动启动该服务。如果您想手动测试：

cd /Users/{USERNAME}/Documents/Cline/MCP/strava-mcp-server
npm run build
npm start

使用示例

配置好 Strava MCP 服务后，您可以让 Claude 与您的 Strava 数据进行交互：

• “显示我最近的 Strava 活动”
• “获取我最近一次 Strava 跑步的详细信息”
• “在 Strava 上创建一项新的手动活动”
• “谁为我最近一次 Strava 骑行送出了 kudos？”
• “显示我上次田径场训练的圈数”

故障排除

• 身份验证错误：如果遇到身份验证错误，您的刷新令牌可能已过期。请再次运行 get-strava-token.js 脚本以获取新的刷新令牌。
• 服务未启动：请确保 MCP 设置文件中的服务路径正确，并且已使用 npm run build 构建服务。
• API 速率限制：Strava API 设有速率限制。如果遇到速率限制错误，请等待几分钟后重试。

许可证

本项目采用 MIT 许可证。