MCP Strava

🚀 MCP Strava Server

MCP Strava Server 是一個小型的 Python MCP 服務器，它可以讓 Claude Desktop 讀取你的 Strava 活動數據。你可以提出類似“顯示我最近 10 次跑步的距離和平均配速”這樣的問題。

🚀 快速開始

環境準備

• 操作系統：x64 架構的 Windows 10 或 11
• Python 版本：3.10 或更高版本
• 需安裝 Claude Desktop

安裝步驟

cd C:\Users\AtikantJain\mcp-strava
python -m venv .venv
. .\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

配置流程

1. 在 VS Code 中開始操作，使用 MCP 工具和基於環境的配置編寫 server.py。
2. 在虛擬環境中安裝依賴：mcp[cli]、requests、anyio。
3. 進行 Strava 應用設置：授權回調域設為 localhost，網站設為 http://localhost。
4. 在 Claude Desktop 中添加服務器環境變量：STRAVA_CLIENT_ID、STRAVA_CLIENT_SECRET、STRAVA_REDIRECT_URI、STRAVA_TOKEN_PATH、STRAVA_SCOPES。
5. Claude 通過虛擬環境的 Python 和參數 server.py 啟動 MCP 服務器。

操作流程

1. 在 Claude 中運行 oauth_login。
2. 服務器在 http://localhost:8723/callback 啟動本地回調並打開瀏覽器。
3. 你登錄 Strava 並授權。
4. Strava 攜帶代碼重定向回來。
5. 服務器使用 client_id、client_secret、code 發送 POST 請求 /oauth/token。
6. 若請求成功（200 OK），服務器將 access_token、refresh_token、expires_at 保存到 STRAVA_TOKEN_PATH。
7. 你在 Claude 中調用 list_activities 或 get_activity。
8. 檢查 access_token 是否即將過期：
   • 若過期，服務器使用 refresh_token 發送 POST 請求 /oauth/token 獲取新的令牌。
   • 若未過期，服務器使用 Authorization: Bearer access_token 調用 Strava API。
9. JSON 數據返回給 MCP 服務器，Claude 會給你返回一個摘要信息。

登錄錯誤處理

若在登錄過程中出現 401 或其他錯誤，根據錯誤類型進行以下處理：

• 若 client_secret 無效，在 Claude 環境中修正 STRAVA_CLIENT_SECRET 後再次運行 oauth_login。
• 若 client_id 無效，修正 STRAVA_CLIENT_ID 後再次運行 oauth_login。
• 若 redirect_uri 不匹配，確保 STRAVA_REDIRECT_URI = http://localhost:8723/callback 且儀表盤域為 localhost。
• 若 code 無效或過期，再次運行 oauth_login 並及時授權。

✨ 主要特性

• 工具豐富：提供 oauth_login、list_activities、get_activity 等工具。
• 本地 OAuth 與自動令牌刷新：支持本地 OAuth 認證，並能自動刷新令牌。
• 令牌本地存儲：令牌保存到本地 JSON 文件，且不提交到版本控制。