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.

Related MCP server: iCloud CalDAV MCP Connector

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:

{
  "mcpServers": {
    "myDavServices": {
      // You can name this anything you like
      "command": "npx", // Or simply "node" if it's in your PATH
      "args": ["-y", "@jahfer/dav-mcp-server"], // Path to the main script
      "env": {
        "DAV_PROVIDER": "icloud", // or "fastmail"
        "DAV_USERNAME": "your-username",
        "DAV_PASSWORD": "your-app-specific-password"
      }
    }
  }
}

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.