Trainingpeaks MCP

🚀 TrainingPeaks MCP Server

TrainingPeaksをModel Context Protocol (MCP) を介してClaudeや他のAIアシスタントに接続します。自然な会話を通じて、ワークアウトを照会し、トレーニング負荷を分析し、パワーデータを比較し、フィットネスの傾向を追跡することができます。

API承認不要。公式のTraining Peaks APIは承認が必要ですが、このサーバーはセキュアなクッキー認証を使用しており、ユーザーは数分で設定できます。クッキーはシステムのキーリングに保存され、TrainingPeaks以外の場所には送信されません。

🚀 クイックスタート

このサーバーを使用することで、TrainingPeaksのデータをAIアシスタントと連携し、自然言語で情報を取得できます。以下のセクションでは、セットアップ方法や使用できる機能について説明します。

✨ 主な機能

質問例

AIアシスタントに以下のような質問をすることができます。

• "今年と去年のFTPの進捗を比較して"
• "最高の20分パワーの6週間前のTSSランプレートはどれくらいだったか"
• "レースに向けて準備はできていますか？フォームの傾向と最近のワークアウトの質を表示して"
• "普段、週のどの曜日に最も激しくトレーニングしていますか？"
• "TSSが800を超えた週を見つけ、その後のフォームの変化を表示して"

機能一覧

📦 インストール

オプションA: Claude Codeを使用した自動セットアップ

Claude Code を持っている場合は、以下のプロンプトを貼り付けます。

https://github.com/JamsusMaximus/trainingpeaks-mcp からTrainingPeaks MCPサーバーをセットアップします - クローンし、仮想環境を作成し、インストールしてから、ブラウザからTrainingPeaksのクッキーを取得する方法を説明し、tp-mcp authを実行します。最後に、Claude Desktopの設定に追加します。

Claudeがインストールを処理し、認証手順をステップバイステップで案内します。

オプションB: 手動セットアップ

ステップ1: インストール

git clone https://github.com/JamsusMaximus/trainingpeaks-mcp.git
cd trainingpeaks-mcp
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

ステップ2: 認証

オプションA: ブラウザから自動抽出（最も簡単） ブラウザでTrainingPeaksにログインしている場合:

pip install tp-mcp[browser]  # 初回のみ: ブラウザサポートをインストール
tp-mcp auth --from-browser chrome  # または: firefox, safari, edge, auto

macOSの注意事項: Keychainまたはフルディスクアクセスのセキュリティプロンプトが表示される場合があります。これは正常な現象で、ブラウザのクッキーは暗号化されており、読み取るには許可が必要です。

オプションB: 手動でクッキーを入力

1. app.trainingpeaks.com にログインします。
2. DevTools (F12) を開き、Application タブ → Cookies を選択します。
3. Production_tpAuth を見つけ、その値をコピーします。
4. tp-mcp auth を実行し、プロンプトが表示されたら貼り付けます。

その他の認証コマンド:

tp-mcp auth-status  # 認証されているか確認する
tp-mcp auth-clear   # 保存されたクッキーを削除する

ステップ3: Claude Desktopに追加

以下のコマンドを実行して、設定スニペットを取得します。

tp-mcp config

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) を編集し、mcpServers の中に貼り付けます。複数のサーバーがある場合の例:

{
  "mcpServers": {
    "some-other-server": {
      "command": "npx",
      "args": ["some-other-mcp"]
    },
    "trainingpeaks": {
      "command": "/Users/you/trainingpeaks-mcp/.venv/bin/tp-mcp",
      "args": ["serve"]
    }
  }
}

Claude Desktopを再起動します。これで使用可能です！

💻 使用例

基本的な使用法

tp_get_workouts

日付範囲内のワークアウトをリストします。1回のクエリで最大90日まで。

{ "start_date": "2026-01-01", "end_date": "2026-01-07", "type": "completed" }

tp_get_workout

1つのワークアウトの詳細を取得します。パワー、心拍数、ケイデンス、TSSなどが含まれます。

{ "workout_id": "123456789" }

tp_analyze_workout

詳細なワークアウト分析を取得します。メトリクス、ゾーン、ラップデータが含まれます。完全な時系列データはJSONファイルに保存され、さらなる分析に使用できます。

{ "workout_id": "123456789" }

tp_create_workout

指定された日付に予定されたワークアウトを作成します。

{ "date": "2026-02-01", "sport": "Run", "title": "Easy 5K", "duration_minutes": 30 }

スポーツ: Bike, Run, Swim, Strength, DayOff, Other オプションフィールド: description (最大2000文字), distance_km, tss_planned

tp_get_peaks

ランク付けされた個人記録を取得します。自転車: パワーメトリクス。ランニング: ペース/速度メトリクス。

{ "sport": "Bike", "pr_type": "power20min", "days": 365 }

自転車のタイプ: power5sec, power1min, power5min, power10min, power20min, power60min, power90min, hR5sec, hR1min, hR5min, hR10min, hR20min, hR60min, hR90min ランニングのタイプ: speed400Meter, speed800Meter, speed1K, speed1Mi, speed5K, speed5Mi, speed10K, speed10Mi, speedHalfMarathon, speedMarathon, speed50K, hR5sec, hR1min, hR5min, hR10min, hR20min, hR60min, hR90min

tp_get_fitness

時間経過に伴うトレーニング負荷メトリクスを取得します。

{ "days": 90 }

あるいは、特定の日付範囲をクエリすることもできます。

{ "start_date": "2025-01-01", "end_date": "2025-03-31" }

毎日のCTL（慢性トレーニング負荷/フィットネス）、ATL（急性トレーニング負荷/疲労）、TSB（トレーニングストレスバランス/フォーム）を返します。

tp_get_workout_prs

特定のワークアウト中に設定されたPRを取得します。

{ "workout_id": "123456789" }

📚 ドキュメント

MCPとは

Model Context Protocol は、AIアシスタントを外部データソースに接続するためのオープン標準です。MCPサーバーは、AIモデルがリアルタイムデータを取得するために呼び出すことができるツールを公開し、Claudeなどのアシスタントが自然言語でTraining Peaksアカウントにアクセスできるようにします。

🔧 技術詳細

セキュリティ

要約: あなたのクッキーはディスク上で暗号化され、短期間のOAuthトークンと交換され、Claudeには表示されず、TrainingPeaksにのみ送信されます。サーバーにはネットワークポートがありません。

このサーバーは深層防御を念頭に設計されています。あなたのTrainingPeaksセッションクッキーは機密情報であり、トレーニングデータへのアクセスを許可するため、適切に扱われます。

書き込みアクセス: tp_create_workout は予定されたワークアウトを作成できます。他のすべてのツールは読み取り専用です。サーバーは既存のワークアウトを変更または削除することはできません。

クッキーの保存

あなたのクッキーは決して平文で保存されません。暗号化されたファイルのフォールバックは、PBKDF2で派生したキー（600,000回の反復）とマシン固有のソルトを使用したAES-256-GCM認証暗号化を使用しています。

クッキーがAIに漏洩しない

AIアシスタント（Claude）は決してあなたのクッキーの値を見ることはありません。これを保証するために複数のレイヤーがあります。

1. 返り値のサニタイズ: ツールの結果は、cookie、token、auth、credential、password、または secret を含むキーがClaudeに送信される前にスクラブされます。
2. マスクされたrepr(): BrowserCookieResult と CredentialResult クラスは、__repr__ をオーバーライドして、実際の値ではなく cookie=<present> を表示します。
3. サニタイズされた例外: エラーメッセージは例外のタイプ名のみを使用し、データを含む可能性のある完全なメッセージは使用しません。
4. ログなし: クッキーの値はどのログにも書き込まれません。

ドメインのハードコーディング（変更不可）

ブラウザのクッキー抽出はのみ .trainingpeaks.com にアクセスします。

# From src/tp_mcp/auth/browser.py - HARDCODED, not a parameter
cj = func(domain_name=".trainingpeaks.com")

Claudeはツールのパラメータを介してこれを変更することはできません。唯一のパラメータは browser (chrome/firefox/etc) であり、ドメインではありません。ドメインを変更するにはソースコードを変更する必要があります。

読み取り専用アクセス

このサーバーはTrainingPeaksに対して限定的な書き込みアクセスを提供します。

• ✅ ワークアウト、フィットネスメトリクス、個人記録を照会する
• ✅ 予定されたワークアウトを作成する
• ❌ 既存のワークアウトを変更または削除することはできません
• ❌ アカウント設定を変更することはできません
• ❌ 請求または支払い情報にアクセスすることはできません

ネットワーク公開なし

MCPサーバーは標準入出力のみを使用しています。Claude Desktopとは標準入出力を介して通信し、ネットワークを介しては通信しません。HTTPサーバーはなく、開いているポートもなく、リモートアクセスもありません。

このサーバーができないこと

オープンソース

このサーバーは完全にオープンソースです。実行する前にすべてのコード行を監査することができます。主要なセキュリティファイル:

• - ハードコーディングされたドメインを持つクッキー抽出
• - AES-256-GCM資格情報暗号化
• - Pydantic入力検証
• - 結果のサニタイズ
• - セキュリティテスト

認証フロー

サーバーは2段階の認証プロセスを使用しています。

1. クッキー → OAuthトークン: 保存されたクッキーは短期間のOAuthアクセストークン（1時間で有効期限切れ）と交換されます。
2. 自動更新: トークンはメモリにキャッシュされ、有効期限が切れる前に自動的に更新されます。

これは次のことを意味します。

• tp-mcp auth で一度認証すれば、以降は必要ありません。
• API呼び出しは適切なBearerトークン認証を使用し、クッキーではありません。
• セッションクッキーが期限切れになった場合（通常は数週間後）、Claudeで tp_refresh_auth を使用するか、tp-mcp auth を再度実行します。

開発

pip install -e ".[dev]"
pytest tests/ -v
mypy src/
ruff check src/

📄 ライセンス

MIT