mcp-nextcloud-Kalender

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)

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:

Variable	Beschreibung	Standard	Erforderlich
HAFEN	Server-Port	3001	NEIN
SERVERNAME	MCP-Serverkennung	Nextcloud-Kalender-Server	NEIN
NODE_ENV	Umgebung (Entwicklung/Produktion)	Entwicklung	NEIN
NEXTCLOUD_BASE_URL	Ihre Nextcloud-Server-URL	-	Ja
NEXTCLOUD_USERNAME	Ihr Nextcloud-Benutzername	-	Ja
NEXTCLOUD_APP_TOKEN	Ihr Nextcloud-App-Token	-	Ja
KEEP_ALIVE_INTERVALL	Keep-Alive-Intervall (ms)	30000	NEIN

Entwicklungs-Setup

Für die lokale Entwicklung:

Klonen Sie das Repository
Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie eine .env Datei im Projektstammverzeichnis:

cp .env.example .env

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

Erhalten eines Nextcloud-App-Tokens

Melden Sie sich bei Ihrer Nextcloud-Instanz an
Gehen Sie zu Einstellungen → Sicherheit → App-Passwörter
Erstellen Sie ein neues App-Passwort mit einem Namen wie „MCP-Kalender“
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

Werkzeug	Beschreibung	Parameter
`listCalendars`	Ruft alle verfügbaren Kalender ab	Keiner
`createCalendar`	Erstellt einen neuen Kalender	`displayName` (erforderlich), `color` (optional), `category` (optional), `focusPriority` (optional)
`updateCalendar`	Aktualisiert einen vorhandenen Kalender	`id` (erforderlich), `displayName` (optional), `color` (optional), `category` (optional), `focusPriority` (optional)
`deleteCalendar`	Löscht einen Kalender	`id` (erforderlich)

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

Veranstaltungsmanagement

Werkzeug	Beschreibung	Parameter
`listEvents`	Ruft Ereignisse für einen Kalender ab	`calendarId` (erforderlich), `start` (optional), `end` (optional)
`getEvent`	Ruft ein bestimmtes Ereignis ab	`calendarId` (erforderlich), `eventId` (erforderlich)
`createEvent`	Erstellt ein neues Ereignis	`calendarId` (erforderlich), `summary` (erforderlich), `start` (erforderlich), `end` (erforderlich), `description` (optional), `location` (optional)
`updateEvent`	Aktualisiert ein vorhandenes Ereignis	`calendarId` (erforderlich), `eventId` (erforderlich), [plus alle zu aktualisierenden Ereigniseigenschaften]
`deleteEvent`	Löscht ein Ereignis	`calendarId` (erforderlich), `eventId` (erforderlich)

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

mcp-nextcloud-calendar