Skylight MCP Server

Ein MCP-Server (Model Context Protocol) für die Skylight-Kalender-API. Ermöglicht KI-Assistenten wie Claude die Interaktion mit Ihrem Skylight-Familienkalender, Aufgaben, Listen und mehr.

Funktionen

• Kalender: Kalenderereignisse abfragen („Was steht heute in meinem Kalender?“)

• Aufgaben: Aufgaben anzeigen und erstellen („Geschirrspüler ausräumen zu Aufgaben hinzufügen“)

• Listen: Einkaufs- und To-do-Listen anzeigen („Was steht auf der Einkaufsliste?“)

• Aufgaben: Elemente zur Aufgabenbox hinzufügen („XYZ zu meiner Aufgabenliste hinzufügen“)

• Familie: Familienmitglieder und Geräte anzeigen

• Belohnungen: Belohnungspunkte und verfügbare Belohnungen prüfen

Related MCP server: Google Calendar MCP Server

Schnellstart

Installation

Option 1: npm-Paket (empfohlen)

mcp.json:

{
  "mcpServers": {
    "skylight": {
      "command": "npx",
      "args": ["@eaglebyte/skylight-mcp"],
      "env": {
        "SKYLIGHT_EMAIL": "your_email@example.com",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

Claude Code:

claude mcp add skylight npx @eaglebyte/skylight-mcp \
  -e SKYLIGHT_EMAIL=your_email@example.com \
  -e SKYLIGHT_PASSWORD=your_password \
  -e SKYLIGHT_FRAME_ID=your_frame_id

Option 2: Aus dem Quellcode

git clone https://github.com/TheEagleByte/skylight-mcp.git
cd skylight-mcp && npm install && npm run build

Dann in mcp.json verwenden:

{
  "mcpServers": {
    "skylight": {
      "command": "node",
      "args": ["/path/to/skylight-mcp/dist/index.js"],
      "env": {
        "SKYLIGHT_EMAIL": "your_email@example.com",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

Anweisungen für KI

Kopiere dies in die benutzerdefinierten Anweisungen oder den System-Prompt deiner KI:

Du hast Zugriff auf den Skylight MCP-Server. Skylight ist ein intelligentes Familienkalender-Display, das Kalender, Aufgaben, Einkaufslisten, Mahlzeiten und Belohnungen anzeigt. Verwende die Skylight-Tools, um bei der Verwaltung von Familienplänen und -organisation zu helfen.

Tipps:

• Rufe get_family_members auf, bevor du Aufgaben zuweist, um die Namen der Mitglieder zu erhalten

• Einkaufsartikel werden standardmäßig der Haupt-Einkaufsliste zugeordnet, wenn keine Liste angegeben ist

• Daten akzeptieren „heute“, „morgen“, Wochentagsnamen oder das Format JJJJ-MM-TT

• Einige Tools (Belohnungen, Mahlzeiten, Fotos) erfordern ein Skylight Plus-Abonnement

Voraussetzungen

• Node.js 18+

• Ein Skylight-Konto mit aktivem Abonnement

• Deine Skylight-Frame-ID (siehe Frame-ID finden)

Authentifizierung

Der MCP-Server unterstützt zwei Authentifizierungsmethoden:

Option 1: E-Mail/Passwort (empfohlen)

Verwende deine Skylight-Kontodaten. Der Server meldet sich automatisch an und verwaltet die Tokens.

SKYLIGHT_EMAIL=your_email@example.com
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id

Option 2: Manuelles Token (Legacy)

Erfasse ein Token aus der Skylight-App mit einem Proxy-Tool.

SKYLIGHT_TOKEN=your_token_here
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_AUTH_TYPE=bearer

Frame-ID finden

Du musst weiterhin deine Frame-ID (die Haushaltskennung) finden:

1. Verwende ein Proxy-Tool (Proxyman, Charles oder mitmproxy)

2. Erfasse eine beliebige API-Anfrage aus der Skylight-App

3. Schau dir den URL-Pfad an: /api/frames/{frameId}/...

4. Beispiel: /api/frames/abc123/chores → Frame-ID ist abc123

Konfiguration

Beispiel-.env-Datei:

# Email/password auth (recommended)
SKYLIGHT_EMAIL=your_email@example.com
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_TIMEZONE=America/New_York

Verfügbare Tools

Kalender-Tools

Aufgaben-Tools

Listen-Tools

Aufgaben-Tools

Familien-Tools

Belohnungs-Tools

Beispielabfragen

Nach der Konfiguration kannst du Claude zum Beispiel fragen:

• „Was ist heute in meinem Kalender?“

• „Welche Aufgaben muss ich diese Woche erledigen?“

• „Füge ‚Müll rausbringen‘ zu meinen Aufgaben für morgen hinzu“

• „Was steht auf der Einkaufsliste?“

• „Füge Milch zu meiner Aufgabenliste hinzu“

• „Wer sind die Familienmitglieder auf Skylight?“

• „Wie viele Belohnungspunkte hat jede Person?“

Entwicklung

# Run in development mode (with hot reload)
npm run dev

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

API-Dokumentation

Dieser MCP-Server basiert auf der reverse-engineerten Skylight-API. Die API-Endpunkte wurden mit dem Projekt skylight-api dokumentiert, das Browser-Netzwerkverkehr (HAR-Dateien) in eine OpenAPI-Spezifikation umwandelt.

API-Ressourcen:

• Interaktive API-Dokumentation (Swagger UI)

• API-Referenz (ReDoc)

• OpenAPI-Spezifikation

Wenn du neue API-Endpunkte entdeckst oder Probleme mit der aktuellen Dokumentation findest, trage bitte zum Repository skylight-api bei.

Mitwirken

Beiträge sind willkommen! So kannst du helfen:

1. Forke das Repository und erstelle einen Feature-Branch

2. Nimm deine Änderungen vor mit klaren, beschreibenden Commits

3. Führe Tests aus (npm test) und Linting (npm run lint) vor dem Einreichen

4. Eröffne einen Pull-Request mit einer Beschreibung deiner Änderungen

Entwicklungsumgebung

git clone https://github.com/TheEagleByte/skylight-mcp.git
cd skylight-mcp
npm install
npm run dev  # Start with hot reload

Bereiche für Beiträge

• Unterstützung für neue Skylight-API-Endpunkte hinzufügen

• Fehlerbehandlung und Randfälle verbessern

• Dokumentation erweitern

• Zusätzliche Tests schreiben

Probleme & Support

• Fehlerberichte: Ein Issue öffnen mit Schritten zur Reproduktion

• Funktionswünsche: Ein Issue öffnen mit Beschreibung des Anwendungsfalls

• Fragen: Eine Diskussion starten oder ein Issue öffnen

Bitte füge relevante Details wie deine Node.js-Version, Fehlermeldungen und Konfiguration (mit geschwärzten sensiblen Werten) hinzu.

Lizenz

MIT

Haftungsausschluss

Dies ist eine inoffizielle Integration. Die Skylight-API ist reverse-engineert und kann sich ohne Vorankündigung ändern. Verwendung auf eigenes Risiko.