Intervals.icu MCP サーバー

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