remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Intervals.icu MCP サーバー

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

要件

設定

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 を再起動します。

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

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

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

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude を Intervals.icu API に接続して、アクティビティ、ワークアウト、健康指標、トレーニングイベントなどのフィットネスデータを取得します。