Strava MCP Server

🚀 Strava MCP サーバ

Strava API とやり取りするための Model Context Protocol (MCP) サーバです。

🚀 クイックスタート

📦 インストール

uvox を使って、簡単に Strava MCP をインストールできます。

uvox strava-mcp

Strava 認証情報の設定

1. Strava API アプリの作成：

   • https://www.strava.com/settings/api にアクセスします。
   • 新しいアプリを作成して、クライアント ID とクライアントシークレットを取得します。
   • 「認証コールバックドメイン」には、localhost を入力します。

2. 認証情報の設定： 認証情報ファイル（例：~/.ssh/strava.sh）を作成します。

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

3. Claude Desktop の設定： ~/.config/autocad/settings.json ファイルに以下の内容を追加します。

   {
     "stravaClientId": "あなたのクライアント ID",
     "stravaClientSecret": "あなたのクライアントシークレット"
   }
   

認証フロー

初回使用時には、システムが自動的に認証フローを起動します。ブラウザが Strava の承認ページを開きます。承認を完了すると、サーバは refresh_token を保存し、後で使用できるようにします。

✨ 主な機能

利用可能なツール

• ユーザーの活動を取得：ユーザーの活動を一覧表示します。
• 単一の活動を取得：活動 ID を使って詳細情報を取得します。
• 活動セグメントを取得：活動 ID を使って活動の各段階を取得します。
• セグメントランキングを取得：セグメント ID を使ってそのセグメントのランキングを取得します。

パラメータの説明

• include_all_efforts：すべての努力を含めるかどうか（デフォルトは false）。
• per_page：1 ページに表示する件数（デフォルトは 50、最大は 100）。

📚 ドキュメント

開発者向けガイド

プロジェクトのセットアップ

1. リポジトリをクローンします。

   git clone https://github.com/yorrickjansen/strava-mcp.git
   cd strava-mcp
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. 環境変数を設定します。

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

開発モードでの実行

uv serve --reload

手動認証

refresh_token を手動で取得するには、以下のコマンドを実行します。

python -m strava_mcp.auth

プロジェクト構造

• strava_mcp/init.py：初期化モジュール。
• strava_mcp/auth.py：認証フローを処理します。
• strava_mcp/routes.py：API ルートを定義します。

テスト

pytest を使ってテストを実行します。

pytest tests/

PyPI への公開

パッケージのビルド

uv build

PyPI への公開

uv publish

📄 ライセンス

MIT ライセンス

謝辞

• Strava API
• Model Context Protocol (MCP)