Intervals.icu MCP サーバー

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

要件

• Python 3.10以上

• モデルコンテキストプロトコル (MCP) Python SDK

• httpx

• Python-dotenv

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キーの取得

1. Intervals.icuアカウントにログイン

2. 設定 > API へ移動

3. 新しいAPIキーを生成する

アスリートIDを見つける

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

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

使用法

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

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

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

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

2. 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

3. 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