Strava MCP

該項目是一個基於TypeScript的Strava API橋接服務，通過MCP標準將Strava的運動數據功能暴露為LLM可調用的工具，支持活動統計、路線導出、心率分析等多種運動數據交互功能。

健康與養生教育與學習工具 #運動數據 #API橋接 #數據分析 #健康追蹤 .TypeScript

評分 : 2.5分

下載量 : 49

更新時間 : 2025-04-29

什麼是Strava MCP服務?

這是一個連接Strava運動平臺與AI助手的智能服務，可以將您的運動數據（如跑步、騎行記錄）轉化為AI可理解的格式，讓您通過自然語言查詢和分析運動表現。

如何使用本服務?

只需安裝配置後，向您的AI助手提問關於Strava數據的問題，如'顯示我上週的跑步數據'或'分析最後一次騎行的功率輸出'。

適用場景

適合運動員、健身愛好者通過AI進行：訓練數據分析、表現追蹤、路線規劃、運動社交互動等場景。

主要功能

活動數據查詢獲取詳細的運動記錄信息，包括距離、時長、心率、功率等指標

路線導出將保存的路線導出為GPX/TCX格式文件，方便導入導航設備

分段分析查看特定路段的詳細數據和歷史表現記錄

流式數據獲取高精度的時間序列數據（心率、功率、踏頻等）用於深度分析

優勢與侷限性

優勢

自然語言交互 - 用說話的方式查詢複雜運動數據

自動化分析 - AI自動生成訓練洞察和建議

數據可視化 - 自動創建專業圖表展示運動表現

無縫集成 - 與現有Strava賬戶直接連接

侷限性

需要Strava高級賬戶獲取完整數據

部分歷史數據可能不完整

導出文件需要預先配置存儲路徑

如何使用

安裝服務

通過npm安裝服務包並構建項目

配置AI助手

在AI助手配置文件中添加Strava服務設置

Strava認證

運行認證腳本完成Strava賬戶連接

開始查詢

重啟AI助手後即可開始用自然語言查詢運動數據

使用案例

訓練表現分析讓AI教練分析你最近一次高強度訓練的數據

路線規劃查找並導出適合長跑的路線

常見問題

需要Strava付費賬戶嗎？

數據更新延遲多久？

支持哪些運動類型？

🚀 Strava API 函數文檔

本項目提供了一系列與 Strava API 交互的函數，可用於獲取活動詳細信息、活動統計數據以及用戶心率區間設置等，幫助開發者更好地利用 Strava 的數據。

🚀 快速開始

你可以根據需求調用不同的函數，如獲取指定活動的詳細信息、活動詳細統計信息或用戶的心率區間設置。調用時需注意權限要求和輸入參數的正確性。

📚 詳細文檔

get-activity

功能描述

獲取指定活動 ID 的詳細信息。

語法

get-activity <activity_id>

描述

此函數返回指定活動的所有可用數據。需要有效的訪問令牌，並且必須滿足適當的權限。

輸入參數

參數	詳情
`<activity_id>`	指定活動的唯一標識符。

輸出格式

返回 JSON 格式的數據，包含以下字段：

屬性	詳情
`id`	活動 ID。
`name`	活動名稱。
`description`	活動描述（可選）。
`distance`	活動距離。
`elapsed_time`	活動總用時。
`moving_time`	活動中實際運動的時間。
`average_speed`	平均速度。
`max_speed`	最高速度。
`elevation_gain`	總海拔升高。
`start_latlng`	起點經緯度座標。
`end_latlng`	終點經緯度座標。
`map_summary`	活動地圖摘要。
`notes`	活動備註（可選）。

示例請求

{
  "activity_id": 1234567890
}

示例響應片段

{
  "id": 1234567890,
  "name": "Morning Ride",
  "description": null,
  "distance": 34.5,
  "elapsed_time": "02:30:15",
  "moving_time": "02:25:45",
  "average_speed": 16.7,
  "max_speed": 35.2,
  "elevation_gain": 89.3,
  "start_latlng": [37.7749, -122.4189],
  "end_latlng": [37.7749, -122.4189],
  "map_summary": "...",
  "notes": null
}

注意事項

⚠️ 重要提示

需要 activity:read 權限。

活動數據可能因隱私設置而有所不同。

錯誤信息

缺少或無效令牌：401 Unauthorized。
活動未找到：404 Not Found。

get-activity-details

功能描述

獲取指定活動 ID 的詳細統計信息，包括心率、功率、速度和海拔數據。

語法

get-activity-details <activity_id>

描述

此函數返回與活動相關的所有詳細統計數據。需要有效的訪問令牌，並且必須滿足適當的權限。

輸入參數

參數	詳情
`<activity_id>`	指定活動的唯一標識符。

輸出格式

返回 JSON 格式的數據，包含以下字段：

屬性	詳情
`id`	活動 ID。
`name`	活動名稱。
`distance`	活動距離。
`elapsed_time`	活動總用時。
`moving_time`	活動中實際運動的時間。
`average_speed`	平均速度。
`max_speed`	最高速度。
`elevation_gain`	總海拔升高。
`average_heart_rate`	平均心率。
`max_heart_rate`	最高心率。
`average_power`	平均功率。
`max_power`	最大功率。

示例請求

{
  "activity_id": 1234567890
}

示例響應片段

{
  "id": 1234567890,
  "name": "Morning Ride",
  "distance": 34.5,
  "elapsed_time": "02:30:15",
  "moving_time": "02:25:45",
  "average_speed": 16.7,
  "max_speed": 35.2,
  "elevation_gain": 89.3,
  "average_heart_rate": 120,
  "max_heart_rate": 180,
  "average_power": 250,
  "max_power": 300
}

注意事項

⚠️ 重要提示

需要 activity:read 權限。

活動數據可能因隱私設置而有所不同。

錯誤信息

缺少或無效令牌：401 Unauthorized。
活動未找到：404 Not Found。

get-athlete-zones

功能描述

獲取用戶的當前心率區間設置。

語法

get-athlete-zones

描述

此函數返回與用戶相關的心率區間配置。需要有效的訪問令牌，並且必須滿足適當的權限。

輸入參數

無輸入參數。

輸出格式

返回 JSON 格式的數據，包含以下字段：

屬性	詳情
`id`	區間 ID。
`name`	區間名稱。
`min_bpm`	區間下限（心率每分鐘跳動次數）。
`max_bpm`	區間上限（心率每分鐘跳動次數）。

示例響應片段

[
  {
    "id": 1,
    "name": "Zone 1: Active Recovery",
    "min_bpm": 50,
    "max_bpm": 60
  },
  {
    "id": 2,
    "name": "Zone 2: Steady State",
    "min_bpm": 61,
    "max_bpm": 70
  },
  {
    "id": 3,
    "name": "Zone 3: Threshold",
    "min_bpm": 71,
    "max_bpm": 80
  }
]