strava-mcp

Strava MCP サーバー

AI を使って Strava のデータと会話しましょう。

Claude を Strava アカウントに接続すると、自然な英語で質問できます。「今月は何キロ走った？」「最後のライドを分析して」「最速のセグメントを表示して」など。

何ができますか？

接続したら、Strava の全データにアクセスできる友人と話すように、Claude に話しかけるだけです。

🏃 進捗を追跡する

「今月は何キロ走りましたか？」

「1月から12月までのランニング統計を比較して」

「これまでで最長のライドは何ですか？」

📊 ワークアウトを分析する

「最後のサイクリングワークアウトを詳しく分析して。パワー、心拍数、ケイデンスを表示して」

「昨日のランニング中、心拍数ゾーンはどのような状態でしたか？」

「インターバルトレーニングの各ラップの平均ペースは？」

🗺️ ルートとセグメントを探索する

「セントラルパーク付近で最も人気のあるサイクリングセグメントはどれですか？」

「スター付きのセグメントを表示して」

「日曜朝のルートを GPX ファイルとしてエクスポートして」

🏆 コーチングの分析情報を得る

「今週のトレーニング負荷を分析して」

「現在のフィットネスを先月と比較するとどうですか？」

「今年のサイクリングのパフォーマンスをまとめて」

クイックスタート（3 ステップ）

ステップ 1：Claude Desktop に追加する

Claude Desktop の設定ファイルを開きます。

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

ファイルに以下を追加します。

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "@r-huijts/strava-mcp-server"]
    }
  }
}

ステップ 1（別の方法）：Claude Code に追加する

次のコマンドで、この MCP サーバーを Claude Code に追加できます。

claude mcp add --transport stdio strava -- npx @r-huijts/strava-mcp-server

次のようにして、インストールが成功したことを確認できます。

% claude mcp list
Checking MCP server health...

strava: npx @r-huijts/strava-mcp-server - ✓ Connected

ステップ 2：Claude Desktop を再起動する

Claude Desktop を終了して再度開き、新しい設定を読み込みます。

ステップ 3：Strava に接続する

Claude に次のように話しかけます。

「Strava アカウントに接続して」

ブラウザーウィンドウが開きます。Strava API の認証情報を入力してアプリを認証すれば完了です。

これだけです！ アクティビティについて質問してみましょう。

Strava アカウントへの接続

初回セットアップ

「Strava アカウントに接続して」と言うと、次のことが行われます。

1. ブラウザーウィンドウが開き、セットアップページが表示されます
2. Strava API の認証情報（Client ID と Client Secret）を入力します
3. 「Continue to Strava」をクリックすると、Strava にリダイレクトされます
4. Strava のウェブサイトでアプリを認証します
5. 成功メッセージが表示されたら、ブラウザーを閉じて構いません
6. 完了です！ Claude が接続完了を確認します

認証情報は ~/.config/strava-mcp/config.json にローカル保存され、セッションをまたいで保持されます。

Strava API の認証情報を取得する

無料の Strava API アプリケーションを作成する必要があります（初回のみ）。

1. strava.com/settings/api にアクセスします
2. 「Create an App」をクリックします（または既存のアプリを表示します）
3. フォームに入力します。
   • Application Name：任意の名前（例：「My Claude Assistant」）
   • Category：任意の項目を選択
   • Website：任意の内容（例：http://localhost）
   • Authorization Callback Domain：localhost にする必要があります
4. Client ID と Client Secret をコピーします

これで完了です。この手順は一度だけ行えばよいです。

接続を管理する

• 状態を確認する：「Strava に接続されていますか？」
• 再接続する：「Strava アカウントに接続して」（再接続するには force: true を使用します）
• 接続を解除する：「Strava アカウントの接続を解除して」

インストール方法

オプション A：そのまま使う（推奨）

インストールは不要です。クイックスタートの npx コマンドが、最新バージョンを自動的にダウンロードして実行します。

オプション B：グローバルにインストールする

一度だけインストールしたい場合は、次のようにします。

npm install -g @r-huijts/strava-mcp-server

次に、Claude の設定を更新して、以下を使用します。

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp-server"
    }
  }
}

注： パッケージ名は @r-huijts/strava-mcp-server ですが、後方互換性のため、実行ファイル名は引き続き strava-mcp-server です。

オプション C：ソースからビルドする

コードを変更したい開発者向けです。

git clone https://github.com/r-huijts/strava-mcp.git
cd strava-mcp
npm install
npm run build

次に、ローカルのビルドを Claude に指定します。

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/path/to/strava-mcp/dist/server.js"]
    }
  }
}

会話例

朝のチェックイン

あなた：今週はどんな運動をしましたか？

Claude：今週の Strava のアクティビティを見ると、次の運動を完了しています。

• 月曜日：5.2km のランニング（28:15）
• 水曜日：45km のサイクリング（1:32:00）
• 土曜日：10km のランニング（52:30）

合計：3 件のアクティビティで 60.2km です。継続できていますね！

ワークアウトの分析

あなた：直近のサイクリングのワークアウトを詳しく分析してください

Claude：昨日の「Evening Loop」のライドを分析すると、次のとおりです。

概要

• 距離：42.3 km
• 時間：1:28:45
• 平均速度：28.6 km/h

パワー分析

• 平均パワー：185W
• 標準化パワー：198W
• 最大パワー：520W

心拍数

• 平均：142 bpm
• 最大：175 bpm
• ゾーン 4 以上の時間：23 分

パワーと心拍数の比率から、優れた有酸素効率がうかがえます……

新しいルートを探す

あなた：コロラド州ボルダー近郊で、挑戦しがいのあるサイクリングの登坂ルートを探してください

Claude：ボルダー近郊で人気の登坂セグメントをご紹介します。

1. Flagstaff Road - 5.2km、平均勾配 6.8%
2. Sunshine Canyon - 3.8km、平均勾配 7.2%
3. Left Hand Canyon - 8.1km、平均勾配 4.5%

後で簡単に見つけられるように、いずれかをお気に入りに登録しますか？

利用可能なツール

アカウントとプロフィール

アクティビティ

統計と進捗

セグメント

ルート

クラブ

ワークアウト

サーバー

トラブルシューティング

「Strava アカウントを接続して」がブラウザーを開かない

• Claude Desktop が MCP サーバーを実行していることを確認してください（Claude でエラーを確認してください）
• Claude Desktop を再起動してみてください
• ポート 8111 がファイアウォールでブロックされていないか確認してください

「認証に失敗しました」または「無効なトークン」

• トークンの有効期限が切れている可能性があります。「Strava アカウントを接続して」と伝えて再接続してください
• strava.com/settings/api で Strava API アプリケーションがまだ有効であることを確認してください

「認証情報がありません」というエラー

• OAuth フローを完了する必要があります。「Strava アカウントを接続して」と伝えてください
• 環境変数を使用している場合は、4 つすべてが設定されていることを確認してください（「開発者向け」セクションを参照）

Claude に Strava のツールが表示されない

• claude_desktop_config.json が有効な JSON であることを確認してください（末尾にカンマを付けないでください！）
• 設定を変更した後、Claude Desktop を再起動してください
• Claude の開発者コンソールでエラーメッセージを確認してください

パッケージ名を変更した後に JSONRPC.ProtocolTransportError が発生する

@r-huijts/strava-mcp-server に更新した後に JSONRPC エラーが発生する場合：

1. npx キャッシュをクリアする：ターミナルで rm -rf ~/.npm/_npx を実行します
2. 設定を確認する：古い strava-mcp-server ではなく、@r-huijts/strava-mcp-server が使われていることを確認します
3. Claude Desktop を完全に再起動する（終了して再度開きます）
4. 手動でテストする：npx -y @r-huijts/strava-mcp-server を実行します。「Starting Strava MCP Server v1.2.1...」と表示されるはずです

開発者向け

npm install
npm run build
npm test

ライセンス

MIT License。詳細については LICENSE ファイルを参照してください。

質問がありますか？ GitHub で issue を作成してください。