MCP Nextcloud-Kalender

Ein Model Context Protocol (MCP)-Server für die Nextcloud-Kalenderintegration.

Merkmale

• Kalender aus Nextcloud holen

• ADHS-freundliche Organisationsfunktionen

• MCP-Protokollunterstützung (Streamable HTTP und Legacy HTTP+SSE)

Related MCP server: ical-mcp

Verwendung

Verwendung mit npx

Am einfachsten lässt sich dieses Paket mit npx verwenden:

npx mcp-nextcloud-calendar

Installation

Für die Entwicklung oder lokale Installation:

# Install globally
npm install -g mcp-nextcloud-calendar

# Or install locally
npm install mcp-nextcloud-calendar

MCP-Client-Konfiguration

Zur Verwendung mit einem MCP-Client (wie Claude) fügen Sie diese Konfiguration zu Ihren MCP-Clienteinstellungen hinzu:

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

Angeben einer Version

Sie können eine bestimmte Version des Pakets anheften:

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar@0.1.0"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

Konfiguration

Umgebungsvariablen

Der Server verwendet diese Umgebungsvariablen, wenn möglich mit Standardwerten:

Entwicklungs-Setup

Für die lokale Entwicklung:

1. Klonen Sie das Repository

2. Installieren Sie Abhängigkeiten:

npm install

3. Erstellen Sie eine .env Datei im Projektstammverzeichnis:

cp .env.example .env

4. Bearbeiten Sie die .env Datei mit Ihren Nextcloud-Anmeldeinformationen.

Erhalten eines Nextcloud-App-Tokens

1. Melden Sie sich bei Ihrer Nextcloud-Instanz an

2. Gehen Sie zu Einstellungen → Sicherheit → App-Passwörter

3. Erstellen Sie ein neues App-Passwort mit einem Namen wie „MCP-Kalender“

4. Kopieren Sie das generierte Token in Ihre .env Datei

Entwicklung

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm run test

# Run linting
npm run lint

# Format code
npm run format

API-Endpunkte

• /mcp – Primärer MCP-Endpunkt (Streamabler HTTP-Transport)

• /sse und /messages – Legacy-MCP-Endpunkte (HTTP+SSE-Transport)

• GET /health – Endpunkt für die Integritätsprüfung

• GET /api/calendars - Alle Kalender auflisten

MCP-Tools

Die folgenden MCP-Tools sind registriert und für Kunden verfügbar:

Kalenderverwaltung

⚠️ Berechtigungswarnung : Die Tools updateCalendar und deleteCalendar erfordern möglicherweise spezielle Berechtigungen in Ihrer Nextcloud-Instanz. Kalendervorgänge unterliegen dem Berechtigungssystem von Nextcloud.

Veranstaltungsmanagement

Bekannte Probleme und Einschränkungen

Hinweis : Dieses Paket befindet sich derzeit in der frühen Entwicklungsphase (0.1.x). APIs und Tools können sich in zukünftigen Versionen ohne vorherige Ankündigung ändern.

• Für die Aktualisierungs- und Löschvorgänge im Kalender sind möglicherweise bestimmte Berechtigungen in Ihrer Nextcloud-Instanz erforderlich.

• Die Fehlerbehandlung für bestimmte Nextcloud-Fehlercodes wird noch verbessert

• Bei großen Kalendern mit vielen Ereignissen kann es zu Leistungsproblemen kommen

Bitte melden Sie alle Probleme im GitHub-Repository.

Lizenz

ISC