Strava

🚀 Strava MCP 服務器

Strava MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 Strava API 的訪問能力。藉助該服務器，語言模型可以與 Strava 數據進行交互，涵蓋活動、運動員信息等多個方面，為用戶帶來更便捷的數據查詢與分析體驗。

🚀 快速開始

Strava MCP 服務器為語言模型與 Strava 數據的交互搭建了橋樑。以下是啟動服務器的詳細步驟。

✨ 主要特性

• 🏃♂️ 活動跟蹤與分析：精準跟蹤並深入分析各類運動活動。
• 📊 運動員統計信息：全面呈現運動員的各項統計數據。
• 🗺️ 路線可視化：直觀展示運動路線。
• 🏆 成就追蹤：記錄並追蹤運動員的成就。
• 🤝 社交功能（點贊、評論）：支持與其他運動員進行社交互動。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp

創建虛擬環境

python -m venv venv
source venv/bin/activate  # 在 Windows 上：.\venv\Scripts\activate

安裝依賴項

pip install -r requirements.txt

📚 詳細文檔

配置

配置文件設置

創建一個 config/.env 文件，輸入您的 Strava API 憑證：

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

獲取 Strava API 憑證

• 訪問 https://www.strava.com/settings/api
• 創建一個新應用程序
• 記下您的客戶端 ID 和客戶端密鑰
• 按照 OAuth 2.0 流程獲取刷新令牌

使用方法

與 Claude 結合使用

連接後，您可以通過 Claude 以多種方式與您的 Strava 數據交互：

活動查詢

• "顯示我最近的活動"
• "獲取我上次跑步的詳細信息"
• "這個月我的最長騎行是什麼？"
• "顯示我設置個人記錄的活動"
• "展示最新活動的路線地圖"

性能分析

• "今年我的平均跑步配速是多少？"
• "過去一週我最常鍛鍊的時間段是哪些？"
• "我的最大心率是多少？"
• "我的平均心率是多少？"
• "我的消耗了多少卡路里？"

數據可視化

• "繪製我最近的活動地圖"
• "生成我過去一個月的跑步距離圖表"
• "展示我的心率分佈圖"
• "顯示我的配速變化趨勢"
• "繪製我的海拔 profile 圖"

社交互動

• "推薦一些與我水平相當的運動員"
• "分享我的活動到社交媒體"
• "獲取好友最近的活動更新"
• "比較我和好友的跑步數據"
• "分析我在社區中的排名"

其他功能

活動日曆

• "顯示我未來兩週的計劃活動"
• "生成我過去一年的活動年表"
• "按月份統計我的活動頻率"
• "標記我所有已完成的活動"
• "提醒我即將到來的重要比賽"

健康分析

• "評估我的訓練負荷指數 (TLI)"
• "計算我的恢復需求評分 (RPE)"
• "提供基於數據的訓練建議"
• "分析我的疲勞狀態"
• "推薦適當的休息和恢復計劃"

數據導出

• "將我過去一年的數據導出為 CSV 文件"
• "生成適合 Excel 分析的報表"
• "下載我的活動軌跡 GPX 文件"
• "輸出心率和配速的詳細日誌"
• "保存所有照片到本地文件夾"

開發

項目結構

1. 主目錄
   • strava_mcp_server.py：主服務器腳本
   • config/：配置文件和環境變量
   • models/：模型和算法實現
   • data/：數據存儲和處理
   • api/：API 接口定義和路由

貢獻指南

1. 叉倉庫
2. 創建功能分支
3. 提交您的更改
4. 推送到分支
5. 創建拉取請求

安全注意事項

• 防止數據洩露：

  • 禁止提交 .env 文件或其他包含敏感信息的文件到版本控制系統。
  • 使用環境變量來管理所有敏感配置，避免硬編碼。

• 代碼安全：

  • 輸入驗證：對用戶輸入進行嚴格的檢查和過濾，防止注入攻擊。
  • 認證授權：實施多層次的身份認證機制，確保只有授權用戶才能訪問敏感數據。
  • 數據加密：在傳輸和存儲過程中對敏感信息進行加密處理，使用 HTTPS 進行通信。

• 日誌記錄：

  • 記錄詳細的錯誤日誌和操作日誌，及時發現異常行為。
  • 定期審查日誌文件，監控潛在的安全威脅。

• 定期審計：

  • 定期對代碼進行安全審計，識別潛在漏洞。
  • 關注最新的安全公告，及時修復已知漏洞。

📄 許可證

本項目使用 MIT 許可證，詳細信息請參閱 LICENSE 文件。

致謝

• Strava API 文檔
• Model Context Protocol (MCP) 規範
• 貢獻者和維護者