DAV MCP Server

DAV MCP Server

Greifen Sie über MCP auf Ihre Kalender, Kontakte und Dateien zu!

Einführung

Dieses Projekt ist ein Model Context Protocol (MCP)-Server, der die Interaktion mit Ihren CalDAV-, CardDAV- und WebDAV-Diensten ermöglicht. Es unterstützt sowohl Fastmail- als auch Apple iCloud-Konten, die über Umgebungsvariablen konfiguriert werden.

Aufstellen

1. Voraussetzungen : Stellen Sie sicher, dass Sie Node.js installiert haben.
2. Repository klonen : Klonen Sie dieses Repository auf Ihrem lokalen Computer.
3. Abhängigkeiten installieren : Navigieren Sie zum Projektverzeichnis und führen Sie Folgendes aus:
   npm install
   Wenn Sie dies als globalen Befehl veröffentlichen oder verwenden möchten, können Sie nach der Installation auch npm link ausführen oder es global über npm install -g . (sobald package.json bei Bedarf für die globale Installation konfiguriert ist).

Konfiguration der Umgebungsvariablen

Um eine Verbindung zu Ihren DAV-Diensten herzustellen, müssen Sie beim Ausführen der Anwendung die folgenden Umgebungsvariablen festlegen:

• DAV_PROVIDER : Gibt Ihren DAV-Dienstanbieter an. Stellen Sie fastmail oder icloud ein (ohne Berücksichtigung der Groß- und Kleinschreibung).
• DAV_USERNAME : Ihr Benutzername für den Dienst (z. B. Ihre Fastmail-E-Mail-Adresse oder Apple-ID).
• DAV_PASSWORD : Ein app-spezifisches Passwort für den Dienst. Aus Sicherheitsgründen wird dringend empfohlen, app-spezifische Passwörter zu verwenden.

MCP-Konfiguration

Um diesen Server zu verwenden, müssen Sie ihn in Ihrer MCP-Konfigurationsdatei als mcpServer konfigurieren. Hier ist ein Beispiel:

Verfügbare Tools

Nach der Konfiguration bietet dieser MCP-Server die folgenden Tools:

Kalender (CalDAV)

• get_my_calendars : Listet alle Ihre verfügbaren Kalender auf.
• get_calendar_events : Ruft Ereignisse aus einem angegebenen Kalender ab. Sie können optional ein Start- und Enddatum/-zeit angeben, um Ereignisse innerhalb eines bestimmten Zeitraums zu filtern.

Kontakte (CardDAV)

• get_my_contact_lists : Listet alle Ihre Kontaktadressbücher auf.
• get_contacts_from_list : Ruft Kontakte aus einem angegebenen Adressbuch ab.

Dateien (WebDAV – hauptsächlich für Fastmail)

• list_my_files_and_folders : Listet Dateien und Ordner innerhalb eines angegebenen Pfads in Ihrem WebDAV-Speicher auf (standardmäßig das Stammverzeichnis).
• get_file_or_folder_details : Ruft Metadaten für eine bestimmte Datei- oder Ordner-URL ab.

Verwendung

Nachdem Sie den MCP-Server in Ihrer Konfiguration eingerichtet haben, können Sie Befehle oder Funktionen in Ihrem MCP-Client verwenden, die mit der Serverdefinition interagieren, um Ihre Kalender, Kontakte und Dateien zu verwalten.