Strava MCP Server

🚀 Strava MCP サーバー

Model Context Protocol (MCP) サーバーで、Strava API へのアクセスを提供します。これにより、言語モデルが認証済みの選手の活動データを照会することができます。

🚀 クイックスタート

このサーバーを使用することで、言語モデルが Stava API を介して認証済み選手の活動データにアクセスできるようになります。以下に、サーバーの使用方法や関連情報を説明します。

✨ 主な機能

利用可能なツール

このサーバーは、以下のツールを公開しています。

活動照会

• get_activities(limit: int = 10)：認証済みのアスリートの最近の活動を取得します。
• get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30)：特定の日付範囲内の活動を取得します。
• get_activity_by_id(activity_id: int)：特定の活動の詳細情報を取得します。
• get_recent_activities(days: int = 7, limit: int = 10)：過去 X 日以内の活動を取得します。

日付は ISO 形式（YYYY-MM-DD）で提供する必要があります。

活動データ形式

サーバーは、一貫したフィールド名と単位を持つ活動データを返します。

📦 インストール

このサーバーを使用するには、Strava API で認証する必要があります。以下の手順に従ってください。

1. Strava API アプリを作成します。

   • Strava API 設定にアクセスします。
   • アプリを作成して、Client ID と Client Secret を取得します。
   • 認証コールバックドメインを localhost に設定します。

2. リフレッシュトークンを取得します。

   • 同梱の get_strava_token.py スクリプトを使用します。

     python get_strava_token.py
     

   • 指示に従って Strava の資格情報を入力し、リフレッシュトークンを取得します。

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

   • 以下の内容を .env ファイルまたは対応する設定ファイルに追加します。

     STRAVA_REFRESH_TOKEN=your_refresh_token_here
     

📚 ドキュメント

MCP サーバーの設定

使用する言語モデル（Claude Desktop または Web）に応じて、以下の手順で設定してください。

Claude Desktop

1. ~/.config/anthropic/claude/settings.json を開きます。
2. "mcp" の下に Strava プラグインを追加します。

   "plugins": {
     "strava": {
       "enabled": true,
       "api_key": "your_api_key",
       "refresh_token": "your_refresh_token"
     }
   }
   

3. ファイルを保存し、Claude を再起動します。

Claude Web

1. Claude Web にアクセスします。
2. 設定ページに移動します。
3. MCP セクションに Strava プラグインを追加します。
   • API キー：your_api_key
   • リフレッシュトークン：your_refresh_token

💻 使用例

例の照会

以下は、すぐに使い始めるのに役立ついくつかの例の照会です。

最近の活動を照会する

print(strava.get_recent_activities())

特定の活動の詳細情報を取得する

activity_id = 123456789
print(strava.get_activity_by_id(activity_id))

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

⚠️ 重要提示

• API キーとリフレッシュトークンを安全に保管し、漏洩を防いでください。
• 定期的にリフレッシュトークンを更新し、期限切れを防いでください。
• エラー処理については、ドキュメントのエラー処理のセクションを参照してください。

以上の手順に従えば、Strava データを言語モデルに簡単に統合し、その機能を拡張することができます。