MCP Strava

🚀 MCP Strava Server

この小型のPython MCPサーバーは、Claude DesktopがStravaのアクティビティを読み取ることを可能にします。例えば、「直近10回のランニングの距離と平均ペースを表示して」などの問い合わせができます。

🚀 クイックスタート

下記のフローチャートは、MCP Stravaサーバーのセットアップと使用の全体的な流れを示しています。

flowchart TD
    A[Start in VS Code] --> B[Write server.py with MCP tools and env based config]
    B --> C["Install deps in venv: mcp[cli], requests, anyio"]
    C --> D["Strava app settings: Authorisation Callback Domain = localhost, Website = http://localhost"]
    D --> E["In Claude Desktop add server env vars:<br/>STRAVA_CLIENT_ID, STRAVA_CLIENT_SECRET,<br/>STRAVA_REDIRECT_URI, STRAVA_TOKEN_PATH, STRAVA_SCOPES"]
    E --> F[Claude launches MCP server via venv python and args server.py]
    F --> G{You run oauth_login in Claude}
    G --> H[Server starts local callback on http://localhost:8723/callback and opens browser]
    H --> I[You sign in to Strava and authorise]
    I --> J[Strava redirects back with code]
    J --> K["Server POST /oauth/token with client_id, client_secret, code"]
    K --> |200 OK| L["Server saves access_token, refresh_token, expires_at to STRAVA_TOKEN_PATH"]
    L --> M[You call list_activities or get_activity from Claude]
    M --> N{Is access_token expired soon}
    N -- Yes --> O["Server POST /oauth/token with refresh_token to get new tokens"]
    O --> L
    N -- No --> P["Server calls Strava API with Authorization: Bearer access_token"]
    P --> Q[JSON returns to MCP server]
    Q --> R[Claude replies to you with a summary]

    %% Error branch during login
    K --> |401 or other error| S{Error type}
    S --> |client_secret invalid| T[Fix STRAVA_CLIENT_SECRET in Claude env then run oauth_login again]
    S --> |client_id invalid| U[Fix STRAVA_CLIENT_ID then run oauth_login again]
    S --> |redirect_uri mismatch| V[Keep STRAVA_REDIRECT_URI = http://localhost:8723/callback and dashboard domain = localhost]
    S --> |code invalid or expired| W[Run oauth_login again and authorise promptly]

✨ 主な機能

• ツール：oauth_login、list_activities、get_activity を提供します。
• ローカルOAuth：自動的にトークンを更新します。
• トークン保存：トークンはコミットされないローカルのJSONファイルに保存されます。

📦 インストール

前提条件

• 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

💻 使用例

基本的な使用法

Claude DesktopからStravaのアクティビティを取得するには、まず oauth_login を実行して認証を行います。その後、list_activities や get_activity を使用してアクティビティを取得できます。

# ここに具体的なコード例を追加できますが、元のREADMEにはなかったため省略

高度な使用法

アクセストークンが期限切れに近い場合、サーバーは自動的にリフレッシュトークンを使用して新しいトークンを取得します。これにより、連続してStrava APIを呼び出すことができます。

# ここに高度なコード例を追加できますが、元のREADMEにはなかったため省略