Intervals.icu MCP サーバー

Name: Intervals.icu MCP Server
Author: mvilanova

Claude と Intervals.icu API を接続するための Model Context Protocol (MCP) サーバー。アクティビティ、イベント、ウェルネスデータの認証とデータ取得のためのツールを提供します。

要件

Related MCP server: Education Data MCP Server

設定

1. uvをインストールする（推奨）

curl -LsSf https://astral.sh/uv/install.sh | sh

2. このリポジトリをクローンする

git clone https://github.com/mvilanova/intervals-mcp-server.git cd intervals-mcp-server

3. 仮想環境を作成してアクティブ化する

# Create virtual environment uv venv # Activate virtual environment # On macOS/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate

4. 依存関係をインストールする

uv pip install -e .

5. 環境変数を設定する

次のコマンドを実行して、 .env.exampleのコピーを作成し、 .envという名前を付けます。

cp .env.example .env

次に、 .envファイルを編集し、Intervals.icu アスリート ID と API キーを設定します。

API_KEY=your_intervals_api_key_here ATHLETE_ID=your_athlete_id_here

Intervals.icu APIキーの取得

Intervals.icuアカウントにログイン
設定 > API へ移動
新しいAPIキーを生成する

アスリートIDを見つける

アスリートIDは通常、Intervals.icuにログインするとURLに表示されます。例：

https://intervals.icu/athlete/i12345/...``i12345はあなたのアスリートIDです

使用法

1. Claudeデスクトップを設定する

このサーバーを Claude Desktop で使用するには、Claude Desktop 構成に追加する必要があります。

Claude Desktop を構成するには、 intervals_mcp_serverディレクトリから次のコマンドを実行します。

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"

Claude デスクトップアプリの構成ファイルclaude_desktop_config.jsonを開くと、次のようになります。

{ "mcpServers": { "Intervals.icu": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py" ] } } }

ここで/path/to/は、システム内のintervals-mcp-serverコードフォルダーへのパスです。

Claude Desktop を開いた際に以下のエラーメッセージが表示される場合は、 claude_desktop_config.json設定ファイルの command キーにuvへのフルパスを指定してください。ターミナルでwhich uv実行すると、フルパスを取得できます。

2025-04-28T10:21:11.462Z [info] [Intervals.icu MCP Server] Initializing server... 2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT 2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT 2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Server transport closed 2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Client transport closed

Claude Desktop を再起動します。

2. クロードとMCPサーバーを使用する

サーバーが稼働し、Claude Desktop が設定されると、次のツールを使用して、過去および将来のアクティビティ、イベント、健康データについて質問できるようになります。

get_activities : アクティビティのリストを取得する
get_activity_details : 特定のアクティビティの詳細情報を取得する
get_activity_intervals : 特定のアクティビティの詳細な間隔データを取得する
get_wellness_data : ウェルネスデータを取得する
get_events : 今後のイベント (ワークアウト、レースなど) を取得します。
get_event_by_id : 特定のイベントの詳細情報を取得する

ライセンス

GNU 一般公衆利用許諾書 v3.0

特集

グラマ.ai

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Intervals.icu MCP Server