Strava

🚀 Strava MCP サーバ

Strava API へのアクセスを提供する Model Context Protocol (MCP) サーバです。このサーバを使用すると、言語モデルが Strava のデータ（アクティビティやアスリート情報など）とやり取りできます。

✨ 主な機能

• 🏃♂️ アクティビティの追跡と分析
• 📊 アスリートの統計情報
• 🗺️ ルートの可視化
• 🏆 実績の追跡
• 🤝 ソーシャル機能（いいね、コメント）

📦 インストール

前提条件

• Python 3.12 以上
• Strava API の認証情報
• pip（Python パッケージ管理ツール）

インストール手順

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

git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # Windowsの場合は .\venv\Scripts\activate

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

pip install -r requirements.txt

🛠️ 設定

1. config/.env ファイルを作成し、Strava API の認証情報を入力します。

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

2. Strava API の認証情報を取得する方法：
   • https://www.strava.com/settings/api にアクセスします。
   • 新しいアプリケーションを作成します。
   • クライアント ID とクライアントシークレットをメモします。
   • OAuth 2.0 フローに従ってリフレッシュトークンを取得します。

💻 使用例

Claude との連携使用

接続後、Claude を通じて Strava データと様々な方法でやり取りできます。

アクティビティのクエリ

• "最近のアクティビティを表示して"
• "前回のランニングの詳細情報を取得して"
• "今月の最長のサイクリングはいつ？"
• "自己記録を達成したアクティビティを表示して"
• "最新のアクティビティのルートマップを表示して"

パフォーマンス分析

• "今年の平均ランニングペースは何？"
• "過去1週間で最も頻繁にトレーニングした時間帯は？"
• "最大心拍数は何？"
• "平均心拍数は何？"
• "消費カロリーはいくら？"

データの可視化

• "最近のアクティビティのマップを描画して"
• "過去1か月間のランニング距離のグラフを生成して"
• "心拍数の分布図を表示して"
• "ペースの変化傾向を表示して"
• "標高プロファイル図を描画して"

ソーシャルインタラクション

• "自分と同レベルのアスリートをいくつか推薦して"
• "アクティビティをソーシャルメディアに共有して"
• "友達の最近のアクティビティ更新を取得して"
• "自分と友達のランニングデータを比較して"
• "コミュニティ内での自分のランキングを分析して"

その他の機能

アクティビティカレンダー

• "今後2週間の予定アクティビティを表示して"
• "過去1年間のアクティビティ年表を生成して"
• "月ごとにアクティビティの頻度を集計して"
• "すべての完了したアクティビティをマークして"
• "近い将来の重要なレースを通知して"

健康分析

• "トレーニング負荷指数 (TLI) を評価して"
• "回復必要性評点 (RPE) を計算して"
• "データに基づくトレーニングアドバイスを提供して"
• "疲労状態を分析して"
• "適切な休息と回復計画を推薦して"

データエクスポート

• "過去1年間のデータを CSV ファイルとしてエクスポートして"
• "Excel 分析に適したレポートを生成して"
• "アクティビティの軌跡を GPX ファイルとしてダウンロードして"
• "心拍数とペースの詳細ログを出力して"
• "すべての写真をローカルフォルダに保存して"

🔧 開発

プロジェクト構造

1. メインディレクトリ
   • strava_mcp_server.py：メインサーバースクリプト
   • config/：設定ファイルと環境変数
   • models/：モデルとアルゴリズムの実装
   • data/：データの保存と処理
   • api/：API インターフェースの定義とルーティング

コントリビューションガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

⚠️ セキュリティ注意事項

• データ漏洩の防止：

  • .env ファイルやその他の機密情報を含むファイルをバージョン管理システムにコミットしないでください。
  • 環境変数を使用してすべての機密設定を管理し、ハードコーディングを避けてください。

• コードセキュリティ：

  • 入力検証：ユーザー入力を厳密にチェックし、注入攻撃を防止します。
  • 認証と承認：多層的な認証メカニズムを実装し、承認されたユーザーのみが機密データにアクセスできるようにします。
  • データ暗号化：機密情報を転送と保存の際に暗号化し、通信には HTTPS を使用します。

• ログ記録：

  • 詳細なエラーログと操作ログを記録し、異常行動を早期に発見します。
  • 定期的にログファイルをレビューし、潜在的なセキュリティ脅威を監視します。

• 定期的な監査：

  • 定期的にコードのセキュリティ監査を行い、潜在的な脆弱性を特定します。
  • 最新のセキュリティアナウンスを確認し、既知の脆弱性をすぐに修正します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• Strava API ドキュメント
• Model Context Protocol (MCP) 仕様
• コントリビューターとメンテナー