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

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

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 Resources

Reddit Discussion about this server

Related MCP Servers

Garmin MCP Server
Taxuspt
-
security
-
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 -
95
MIT License
Education Data MCP Server
ckz
A
security
-
license
A
quality
Provides access to Urban Institute's Education Data API through Claude, enabling users to query and analyze detailed educational data from schools, districts, and universities.
Last updated -
2
2
MIT License
Webflow MCP Server
TimKJones
-
security
-
license
-
quality
Enables Claude to interact with Webflow's APIs, allowing access to site information, collections, and other Webflow resources.
Last updated -
193
MIT License
Qlik MCP Server
jwaxman19
-
security
-
license
-
quality
Enables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.
Last updated -
5
MIT License

View all related MCP servers

Intervals.icu MCP Server