Oura MCP Server

Was macht der „Oura“ MCP Server?

Der Oura MCP Server ermöglicht KI-Assistenten den sicheren Zugriff, die Analyse und die Visualisierung von Gesundheitsdaten, die Ihr Oura Ring sammelt, über das Model Controller Protocol (MCP). Als Brücke zwischen der Oura-API und KI-Clients bietet er Entwickler:innen und Nutzer:innen strukturierten Zugriff auf Gesundheitsmetriken wie Schlaf, Readiness, Aktivität und mehr. Der Server unterstützt anpassbare Abfragen, vordefinierte Prompt-Vorlagen für gängige Gesundheitsanalysen sowie automatische Datenvisualisierung. Mit diesem MCP-Server können KI-Assistenten Gesundheitstrends analysieren, Berichte erstellen und aussagekräftige Korrelationen aufdecken – so entstehen reichhaltigere, informativere Health- und Wellness-Erlebnisse.

Liste der Prompts

• Schlafdatenanalyse: Vorlage zum Abrufen und Erklären von Schlafdaten für einen bestimmten Zeitraum.
• Mahlzeiten mit Readiness korrelieren: Analysieren, wie Mahlzeiten oder Ernährungsdaten die Readiness-Scores beeinflussen.
• Stress vs. Wochentagsvergleich: Vergleichen von Stressleveln zwischen Arbeitstagen und Wochenenden.
• Herzfrequenz während des Schlafs analysieren: Abrufen und Auswerten von Herzfrequenzdaten im Schlaf, mit optionalen Filtern (z. B. Alkoholkonsum).
• Schlafeffizienz-Trends visualisieren: Erstellen von Diagrammen, die Trends der Schlafeffizienz oder anderer Metriken zeigen.
• Readiness-Scores vergleichen: Visualisierungsvorlage zum Vergleich der Readiness nach verschiedenen Ereignissen (z. B. Mahlzeiten).

Liste der Ressourcen

• Schlafmetriken: Zugriff auf Oura Ring Schlafdaten, einschließlich Phasen, Dauer, Effizienz und benutzerdefinierte Tags.
• Readiness-Scores: Bereitstellung von Readiness-Werten und deren Einflussfaktoren.
• Aktivitätsdaten: Abruf täglicher und wöchentlicher Aktivitätsmetriken von Oura.
• Herzratenvariabilität (HRV): Detaillierte HRV-Daten für Analyse und Visualisierung.

Liste der Tools

Keine explizite Liste an Tools in server.py oder ähnlicher Datei im bereitgestellten Repository enthalten.

Anwendungsfälle für diesen MCP Server

• Persönliche Schlafanalyse: Entwickler:innen können Assistenten bauen, die Schlafmuster der Nutzer:innen abrufen und interpretieren – mit umsetzbaren Insights und Visualisierungen.
• Korrelation von Mahlzeiten und Readiness: Ermöglicht die Untersuchung, wie Ernährungsgewohnheiten die Readiness und das Wohlbefinden beeinflussen, und unterstützt personalisierte Gesundheitsempfehlungen.
• Stress- und Lifestyle-Vergleich: Erleichtert die Analyse von Stresstrends an verschiedenen Tagen (z. B. Arbeitstage vs. Wochenende) zur Lifestyle-Optimierung.
• Datenvisualisierung von Gesundheitstrends: Nutzer:innen können Diagramme und Grafiken zu Oura-Daten erstellen – hilfreich für Coaching, Reporting oder Selbsttracking.
• Individuelle Gesundheitsabfragen: Unterstützt fortgeschrittene, nutzerspezifische Abfragen (z. B. Herzfrequenz im Schlaf nach Alkoholkonsum) für differenzierte Gesundheitsanalysen.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Node.js v18+ installiert ist.
2. Besorgen Sie sich Ihren Oura Personal Access Token und tragen Sie ihn in eine .env-Datei als OURA_TOKEN=your_personal_access_token ein.
3. Fügen Sie das Oura MCP Server-Paket zu Ihrer Konfiguration hinzu:
4. Bearbeiten Sie die Windsurf-Konfigurationsdatei:

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"]
    }
  }
}

5. Speichern und starten Sie Windsurf neu.
6. Überprüfen Sie, ob der MCP Server läuft und erreichbar ist.

API-Keys absichern (Windsurf)

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"],
      "env": {
        "OURA_TOKEN": "${OURA_TOKEN}"
      },
      "inputs": {
        "OURA_TOKEN": "your_personal_access_token"
      }
    }
  }
}

Claude

1. Installieren Sie Node.js v18+.
2. Richten Sie Ihre .env-Datei mit OURA_TOKEN ein.
3. Fügen Sie den Oura MCP Server zur Claude-Konfiguration hinzu:

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"]
    }
  }
}

4. Speichern Sie, starten Sie Claude neu und bestätigen Sie die erfolgreiche Verbindung.

API-Keys absichern (Claude)

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"],
      "env": {
        "OURA_TOKEN": "${OURA_TOKEN}"
      }
    }
  }
}

Cursor

1. Bestätigen Sie, dass Node.js v18+ installiert ist.
2. Erwerben Sie Ihren Oura Personal Access Token und speichern Sie ihn in .env.
3. Aktualisieren Sie die MCP-Serverliste in Cursor:

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"]
    }
  }
}

4. Speichern Sie die Konfiguration und starten Sie Cursor neu.

API-Keys absichern (Cursor)

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"],
      "env": {
        "OURA_TOKEN": "${OURA_TOKEN}"
      }
    }
  }
}

Cline

1. Installieren Sie Node.js v18 oder höher.
2. Legen Sie Ihren Oura Personal Access Token in einer .env-Datei ab.
3. Fügen Sie den/aktualisieren Sie den MCP-Server-Eintrag in Ihrer Cline-Konfiguration:

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"]
    }
  }
}

4. Speichern Sie die Änderungen, starten Sie Cline neu und testen Sie die Einrichtung.

API-Keys absichern (Cline)

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["@oura/mcp-server@latest"],
      "env": {
        "OURA_TOKEN": "${OURA_TOKEN}"
      }
    }
  }
}

Verwendung dieses MCP in Flows

MCP in FlowHunt nutzen

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Im Bereich für die System-MCP-Konfiguration fügen Sie Ihre MCP-Server-Details in folgendem JSON-Format ein:

{
  "oura": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent diesen MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “oura” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL entsprechend Ihrer eigenen MCP-Server-Adresse anzupassen.

Übersicht

Basierend auf obigem deckt der Oura MCP Server die meisten erforderlichen MCP-Primitiven und Setup-Details ab. Das Fehlen expliziter Tool-Definitionen sowie Sampling-/Root-Unterstützung begrenzt jedoch seine Vollständigkeit als allgemeine MCP-Implementierung. Für Oura-Nutzer:innen bietet er dennoch starke Gesundheits- und Tracking-Funktionen.

MCP-Bewertung

Unsere Bewertung: 5/10.
Der Server bietet gute Dokumentation, Prompt-Vorlagen, Ressourcenzugriff und Setup-Anleitungen, es fehlen jedoch Open-Source-Lizenzierung, explizite Tools sowie Sampling-/Root-Support, was für einen umfassenden MCP-Server wichtig wäre. Er ist geeignet für die persönliche Gesundheitsdatenanalyse, aber kein allgemeiner MCP-Showcase.