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

Related MCP server: Education Data MCP Server

Aufstellen

1. UV installieren (empfohlen)

2. Klonen Sie dieses Repository

3. Erstellen und aktivieren Sie eine virtuelle Umgebung

4. Projektabhängigkeiten synchronisieren

5. Umgebungsvariablen einrichten

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

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

Abrufen Ihres Intervals.icu-API-Schlüssels

1. Melden Sie sich bei Ihrem Intervals.icu-Konto an

2. Gehen Sie zu Einstellungen > API

3. 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.

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

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

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.

3. 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:

Lokales Ausführen des Servers

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

Lizenz

Die GNU General Public License v3.0

Empfohlen

Glama.ai