Strava MCP サーバー

Strava APIへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。言語モデルがStrava 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設定に移動

   • クライアントIDとクライアントシークレットを取得するためのアプリケーションを作成する

   • 認証コールバックドメインをlocalhostに設定する

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

   • 付属のget_strava_token.pyスクリプトを使用します: GXP1

   • 指示に従ってアプリケーションを承認してください

   • スクリプトはトークンを.envファイルに保存します

3. 環境変数を設定する: サーバーには次の環境変数が必要です。

   • STRAVA_CLIENT_ID : Strava APIクライアントID

   • STRAVA_CLIENT_SECRET : Strava APIクライアントシークレット

   • STRAVA_REFRESH_TOKEN : Strava API リフレッシュトークン

使用法

デスクトップ版クロード

claude_desktop_config.json (macOS では~/Library/Application\ Support/Claude/claude_desktop_config.json 、Windows では%APPDATA%/Claude/claude_desktop_config.jsonにあります) を更新して、以下を追加します。

クロード・ウェブ

Claude Web の場合、サーバーをローカルで実行し、MCP 拡張機能を使用して接続できます。

クエリの例

接続すると、次のような質問をクロードに尋ねることができます。

• 「私の最近の活動は何ですか？」

• 「先週のアクティビティを見せてください」

• 「過去 1 か月間での最長ランニング距離はどれくらいでしたか?」

• 「最近のサイクリングアクティビティの詳細を取得する」

エラー処理

サーバーは、一般的な問題に関して人間が判読できるエラー メッセージを提供します。

• 無効な日付形式

• API認証エラー

• ネットワーク接続の問題

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。