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 ファイルを参照してください。