Intervals MCP

ロシア語版

セルフホスト型の読み取り専用MCPサーバーで、AIアシスタントにアスリートのIntervals.icuトレーニングデータへのアクセスを提供します。

スポーツウォッチ、サイクルコンピューター、トレーナー、Strava、その他の対応ソースをIntervals.icuに接続してください。Intervals MCPは、正規化されたトレーニングデータをChatGPT、Claude、Claude Code、Cursor、VS Code、その他のMCPクライアントに公開します。現在の連携についてはIntervals.icuを参照してください。連携リストは時間とともに変わります。

このサーバーはGETリクエストのみを行います。アスリートのIntervals.icuアカウント内の何も作成、編集、削除することはできません。

アシスタントが読み取れる内容

• アスリートプロフィール、タイムゾーン、スポーツ設定、ゾーン、FTP、LTHR、最大心拍数。

• アクティビティ、詳細、ラップ、インターバル、ダウンサンプリングされたストリーム。

• ウェルネス、フィットネス、疲労、HRV、睡眠、気分、体重（利用可能な場合）。

• 予定イベント、ベストエフォート曲線、ギア、ワークアウトライブラリ。

• 読み取り専用のrawツールによる、追加のIntervals.icu v1 GET エンドポイント。

大きなレスポンスはモデルに到達する前に圧縮されます。空のフィールドは削除され、ストリームはダウンサンプリングされ、サマリーは完全なデータ系列を使用します。

Related MCP server: intervals.mcp

クイックスタート

パブリックホスト名を持つUbuntuまたはDebian VPSが必要です。ホスト名のDNSレコードをサーバーに向け、インバウンドのTCPポート80と443を許可してください。インストーラーは、Docker、Compose、Git、uvが不足している場合に追加します：

curl -fsSL https://raw.githubusercontent.com/VictorForV/intervals-mcp/master/install.sh | sudo bash

リモートスクリプトを特権シェルにパイプしたくない場合は、実行前にinstall.shを確認してください。前提条件をインストールした後、リポジトリをクローンして./manage.shを実行する手動インストールも引き続き利用できます。

初期セットアップを選択してください。マネージャーは、パブリックホスト名、短いアスリート名、Intervals.icuのアスリートIDとAPIキーを尋ねます。IDとキーは、Intervals.icuの設定 → 開発者設定で確認できます。APIキーの入力は非表示になります。

マネージャーは、オーナーのみがアクセスできる設定を作成し、強力なランダムURLトークンを生成し、サービスを起動して、コネクタURLを出力します。後で./manage.shを実行すると、アスリートの追加、一覧表示、編集、削除、URLのローテーション、再ビルド、再起動、サービスの検査ができます。

AIクライアントの接続

各アスリートには2つのシークレットURLが発行されます：

https://mcp.example.com/<secret>/mcp  # Streamable HTTP, preferred
https://mcp.example.com/<secret>/sse  # legacy SSE compatibility

完全なURLをパスワードのように扱ってください。そのURLは、そのアスリートのトレーニングおよびウェルネスデータへの読み取りアクセスを許可します。

Claude と Claude Desktop

設定 → コネクタ → カスタムコネクタを追加を開き、/mcp URLを入力します。利用可能性と組織の権限はClaudeプランによって異なります。現在のAnthropicの手順を参照してください。

Claude Code

マネージャーはそのまま実行できるコマンドを出力します：

claude mcp add --transport http intervals-alex https://mcp.example.com/<secret>/mcp

ChatGPT

サーバーをカスタムアプリ/コネクタとして追加し、現在のChatGPTワークスペースで受け入れられるURLを使用します。利用可能性、UI、管理者の要件はプランによって異なり、変更される可能性があります。現在のOpenAIアプリのドキュメントを参照してください。マネージャーは互換性のために両方のURL形式を表示します。

その他のクライアント

リモートのStreamable HTTPクライアントでは/mcpを、古いSSEクライアントでは/sseを使用してください。クライアントの最新のドキュメントに従い、シークレットURLを共有設定にコミットしないでください。

管理

対話型パネルが推奨インターフェースです：

./manage.sh

自動化のために、同じインターフェースにはサブコマンドがあります：

uv run intervals-mcp-admin add
uv run intervals-mcp-admin list
uv run intervals-mcp-admin show alex
uv run intervals-mcp-admin edit alex
uv run intervals-mcp-admin rotate alex
uv run intervals-mcp-admin remove alex

対話型シェルでは--api-keyを避けてください。コマンド引数はシェル履歴に保存されたり、プロセスリストに公開されたりする可能性があるためです。非表示入力にする場合は、このオプションを省略してください。

ローカルstdioモード

1人のアスリートと、ローカルプロセスを起動するクライアントの場合、.env.exampleを.envにコピーし、Intervals.icuの認証情報を設定して、実行します：

uv run intervals-mcp

セキュリティモデル

• Intervals.icuへのリクエストは読み取り専用（GET）です。

• 各アスリートには、個別のAPIクライアントと独立したランダムパストークンが割り当てられます。

• .envとusers.tomlはgitignoreされ、モード0600で書き込まれます。

• APIキーとパストークンは、アプリケーションおよびプロキシのアクセスログから除外されます。

• 公開サービスはCaddyを通じてHTTPSを使用します。

• users.tomlはコンテナに読み取り専用でマウントされます。

パストークンはベアラー認証です。URLを知っている人は誰でもそのアスリートのデータを読み取れます。漏えいした場合は、./manage.shからローテーションしてください。問題の報告についてはSECURITY.mdを参照してください。

開発

uv sync
uv run pytest

テストは完全に合成されたAPI形式のフィクスチャを使用し、ネットワークリクエストを行いません。uv run python scripts/generate_fixtures.pyでそれらを再生成します。

開発ガイドラインについてはCONTRIBUTING.mdを参照してください。

ライセンス

MIT — LICENSEを参照してください。