Tomekkorbak Strava MCP Server

🚀 Strava MCP サーバー

Strava API サーバーで、モデルコンテキストプロトコル (MCP) へのアクセスを提供します。言語モデルがアスリートの活動データを照会できるようにします。

🚀 クイックスタート

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

1. Strava API アプリを作成します。
   • Strava API 設定にアクセスします。
   • ログイン後、新しいアプリを作成します。
   • 生成された Client ID と Client Secret を記録します。
2. リフレッシュトークンを取得します。
   • Strava アプリの資格情報を使用して、OAuth またはその他の方法でリフレッシュトークンを取得します。
   • リフレッシュトークンは、後続のアスリートデータへのアクセスに使用されます。
3. 環境変数を設定します。
   • STRAVA_CLIENT_ID と STRAVA_CLIENT_SECRET を環境に追加します。

Claude Desktop での使用方法

• ターミナルを開き、以下のコマンドを実行します。

python3 src/main.py --config config.yaml

Claude Web での使用方法

• プロジェクトフォルダの内容をサーバーにアップロードします。
• Web アプリを構成して、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）で提供する必要があります。

📦 インストール

インストールに関する具体的な手順は提供されていません。

💻 使用例

基本的な使用法

以下は、基本的な使用例です。具体的なコード例が元の README にないため、ここでは説明のみとなります。

高度な使用法

高度なシナリオでは、上記の各関数を組み合わせて、特定の条件での活動データを取得することができます。

📚 ドキュメント

活動データ形式

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

エラー処理

このサーバーは、ネットワーク問題、認証失敗、または無効な入力などの一般的なエラーに対して、友好的なヒント情報を提供します。

📄 ライセンス

MIT ライセンス