Intervals MCP Server

🚀 Intervals.icu MCP サーバ

モデルコンテキストプロトコル（MCP）サーバは、ClaudeをIntervals.icu APIに接続するために使用されます。認証とアクティビティ、イベント、健康データの取得を実現するツールを提供します。

🚀 クイックスタート

✨ 主な機能

モデルコンテキストプロトコル（MCP）サーバは、ClaudeをIntervals.icu APIに接続し、認証とデータ取得のためのツールを提供します。

📦 インストール

必要条件

• Python 3.10以上
• モデルコンテキストプロトコル（MCP）Python SDK
• httpx
• python-dotenv

インストール手順

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. 仮想環境の作成とアクティブ化

# 仮想環境の作成
uv venv

# 仮想環境のアクティブ化
# macOS/Linuxの場合：
source .venv/bin/activate
# 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 Desktopの設定

このサーバをClaude Desktopとともに使用するには、Claudeの設定ファイルに追加する必要があります。

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

Claude Desktopの設定ファイルclaude_desktop_config.jsonを開くと、以下のようになっているはずです。

{
  "servers": {
    "intervals-mcp-server": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "mcp.cli.run_server", "--server-id=intervals-mcp-server"],
      "cwd": "${fileDirname}"
    }
  },
  "default-runtime": "node"
}

2. Claudeでの使用

設定が完了したら、以下のコマンドを使用してClaudeでサーバを使用できます。

claude config set --server=intervals-mcp-server

これで提供されているツールを使用することができます。

📄 ライセンス

Apache 2.0 ライセンス

特色

Glama.ai