Intervals.icu MCP-Server

Model Context Protocol (MCP)-Server zur Verbindung von Claude mit der Intervals.icu-API. Er bietet Tools zur Authentifizierung und Datenabfrage für Aktivitäten, Ereignisse und Wellnessdaten.

Anforderungen

Python 3.10 oder höher
Model Context Protocol (MCP) Python SDK
httpx
python-dotenv

Aufstellen

1. UV installieren (empfohlen)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Klonen Sie dieses Repository

git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server

3. Erstellen und aktivieren Sie eine virtuelle Umgebung

# Create virtual environment with Python 3.12
uv venv --python 3.12

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

4. Projektabhängigkeiten synchronisieren

uv sync

5. Umgebungsvariablen einrichten

Erstellen Sie eine Kopie von .env.example und nennen Sie sie .env , indem Sie den folgenden Befehl ausführen:

cp .env.example .env

Bearbeiten Sie dann die .env Datei und legen Sie Ihre Intervals.icu-Athleten-ID und Ihren API-Schlüssel fest:

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Abrufen Ihres Intervals.icu-API-Schlüssels

Melden Sie sich bei Ihrem Intervals.icu-Konto an
Gehen Sie zu Einstellungen > API
Generieren Sie einen neuen API-Schlüssel

So finden Sie Ihre Athleten-ID

Ihre Athleten-ID ist normalerweise in der URL sichtbar, wenn Sie bei Intervals.icu angemeldet sind. Sie sieht folgendermaßen aus:

https://intervals.icu/athlete/i12345/... wobei i12345 Ihre Athleten-ID ist

Verwendung

1. Konfigurieren Sie Claude Desktop

Um diesen Server mit Claude Desktop zu verwenden, müssen Sie ihn zu Ihrer Claude Desktop-Konfiguration hinzufügen.

Führen Sie Folgendes aus dem Verzeichnis intervals_mcp_server aus, um Claude Desktop zu konfigurieren:

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu" --with-editable . --env-file .env

Wenn Sie Ihre Claude Desktop App-Konfigurationsdatei claude_desktop_config.json öffnen, sollte sie folgendermaßen aussehen:

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "/Users/<USERNAME>/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/intervals-mcp-server",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ],
      "env": {
        "INTERVALS_API_BASE_URL": "https://intervals.icu/api/v1",
        "ATHLETE_ID": "<YOUR_ATHLETE_ID>",
        "API_KEY": "<YOUR_API_KEY>",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Dabei ist /path/to/ der Pfad zum Codeordner intervals-mcp-server in Ihrem System.

Wenn beim Öffnen von Claude Desktop die folgenden Fehlermeldungen angezeigt werden, geben Sie den vollständigen Pfad zu uv in den Befehlsschlüssel in der Konfigurationsdatei claude_desktop_config.json ein. Sie erhalten den vollständigen Pfad, indem Sie which uv im Terminal ausführen.

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

Starten Sie Claude Desktop neu.

2. Verwenden Sie den MCP-Server mit Claude

Sobald der Server läuft und Claude Desktop konfiguriert ist, können Sie mit den folgenden Tools Fragen zu Ihren vergangenen und zukünftigen Aktivitäten, Ereignissen und Wellnessdaten stellen.

get_activities : Ruft eine Liste der Aktivitäten ab
get_activity_details : Erhalten Sie detaillierte Informationen zu einer bestimmten Aktivität
get_activity_intervals : Erhalten Sie detaillierte Intervalldaten für eine bestimmte Aktivität
get_wellness_data : Wellness-Daten abrufen
get_events : Ruft bevorstehende Ereignisse ab (Trainingseinheiten, Rennen usw.)
get_event_by_id : Erhalten Sie detaillierte Informationen zu einem bestimmten Ereignis

Entwicklung und Tests

Installieren Sie Entwicklungsabhängigkeiten und führen Sie die Testsuite mit:

uv sync --all-extras
pytest -v tests

Lokales Ausführen des Servers

Um den Server manuell zu starten (nützlich bei der Entwicklung oder beim Testen), führen Sie Folgendes aus:

mcp run src/intervals_mcp_server/server.py

Lizenz

Die GNU General Public License v3.0

Empfohlen

Glama.ai

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

Verbindet Claude mit der Intervals.icu-API, um Fitnessdaten wie Aktivitäten, Trainingseinheiten, Wellness-Kennzahlen und Trainingsereignisse abzurufen.

Related MCP Servers

Roam Research
2b3pro
A
security
A
license
A
quality
Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
Last updated -
18
25
38
TypeScript
MIT License
Iaptic MCP Serverofficial
iaptic
A
security
A
license
A
quality
A server for interacting with the Iaptic API, allowing AI models like Claude to query customer, purchase, and transaction data, as well as retrieve statistical insights.
Last updated -
16
4
TypeScript
MIT License
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python
Garmin MCP Server
Taxuspt
-
security
A
license
-
quality
Connects to Garmin Connect and exposes your fitness and health data (activities, sleep, heart rate, steps, body composition) to Claude and other MCP-compatible clients.
Last updated -
1
Python
MIT License

View all related MCP servers

Intervals.icu MCP Server