Mvilanova Intervals MCP Server

🚀 Intervals.icu MCP サーバー

このMCP（Model Context Protocol）サーバーは、ClaudeをIntervals.icu APIに接続するために使用されます。認証と、活動、イベント、健康データの検索ツールを提供します。

🚀 クイックスタート

このMCPサーバーを使用することで、ClaudeとIntervals.icu APIを接続し、活動や健康データを取得できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 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/yourusername/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 Desktopの設定に追加する必要があります。

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP サーバー"

Claude Desktopのアプリケーション設定ファイル 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の使用

サーバーが起動し、Claude Desktopが設定されたら、以下のツールを使用して、過去と未来の活動、イベント、健康データを照会できます。

• get_activities：活動のリストを取得します。
• get_activity_details：特定の活動の詳細情報を取得します。
• get_activity_intervals：特定の活動の詳細な区間データを取得します。
• get_wellness_data：健康データを抽出します。
• get_events：予定されているイベント（トレーニング、試合など）を取得します。
• get_event_by_id：特定のイベントの詳細情報を取得します。

📄 ライセンス

GNU General Public License v3.0