Nextcloud MCP-Server

Ein produktionsreifer MCP-Server, der KI-Assistenten mit Ihrer Nextcloud-Instanz verbindet.

Ermöglichen Sie Large Language Models wie Claude, GPT und Gemini die Interaktion mit Ihren Nextcloud-Daten über eine sichere API. Erstellen Sie Notizen, verwalten Sie Kalender, organisieren Sie Kontakte, arbeiten Sie mit Dateien und mehr – alles durch Konversationen in natürlicher Sprache.

Dies ist ein dedizierter, eigenständiger MCP-Server, der für externe MCP-Clients wie Claude Code und IDEs entwickelt wurde. Er läuft unabhängig von Nextcloud (Docker, VM, Kubernetes oder lokal) und bietet umfassende CRUD-Operationen für Nextcloud-Apps.

[!NOTE] Suchen Sie nach KI-Funktionen innerhalb von Nextcloud? Nextcloud bietet auch den Context Agent, der die Assistant-App antreibt und als ExApp innerhalb von Nextcloud läuft. Siehe docs/comparison-context-agent.md für einen detaillierten Vergleich der Anwendungsfälle.

Schnellstart (Docker)

Für den vollen Funktionsumfang inklusive semantischer Suche, führen Sie es mit Docker aus:

# 1. Create a minimal configuration
cat > .env << EOF
NEXTCLOUD_HOST=https://your.nextcloud.instance.com
NEXTCLOUD_USERNAME=your_username
NEXTCLOUD_PASSWORD=your_app_password
EOF

# 2. Start the server
docker run -p 127.0.0.1:8000:8000 --env-file .env --rm \
  ghcr.io/cbcoutinho/nextcloud-mcp-server:latest

# 3. Test the connection
curl http://127.0.0.1:8000/health/ready

# 4. Connect to the endpoint
http://127.0.0.1:8000/sse

# Or with --transport streamable-http
http://127.0.0.1:8000/mcp

Docker Compose Profile (für Entwicklung/Tests):

docker compose --profile single-user up -d       # Port 8000
docker compose --profile multi-user-basic up -d   # Port 8003
docker compose --profile oauth up -d              # Port 8001
docker compose --profile login-flow up -d         # Port 8004

Nächste Schritte:

• Verbinden Sie Ihren MCP-Client (Claude Desktop, IDEs, mcp dev, etc.)

• Siehe docs/installation.md für weitere Bereitstellungsoptionen (lokal, Kubernetes)

Related MCP server: Nextcloud MCP Server

Hauptfunktionen

• 90+ MCP-Tools - Umfassende API-Abdeckung für 8 Nextcloud-Apps

• MCP-Ressourcen - Strukturierte Daten-URIs zum Durchsuchen von Nextcloud-Daten

• Semantische Suche (Experimentell) - Optionale vektorbasierte Suche für Notizen, Dateien, News-Artikel und Deck-Karten (erfordert Qdrant + Ollama)

• Dokumentenverarbeitung - OCR und Textextraktion aus PDFs, DOCX, Bildern mit Fortschrittsbenachrichtigungen

• Flexible Bereitstellung - Docker, Kubernetes (Helm), VM oder lokale Installation

• Produktionsreife Authentifizierung - Basic Auth mit App-Passwörtern (empfohlen) oder OAuth2/OIDC (experimentell)

• Mehrere Transporte - Unterstützung für SSE, HTTP und streamable-http

Unterstützte Apps

Möchten Sie eine weitere Nextcloud-App unterstützt sehen? Erstellen Sie ein Issue oder reichen Sie einen Pull Request ein!

Authentifizierung

[!IMPORTANT] OAuth2/OIDC ist experimentell und erfordert einen manuellen Patch für die user_oidc-App:

• Erforderlicher Patch: Bearer-Token-Unterstützung (Issue #1221)

• Auswirkung: Ohne den Patch schlagen die meisten app-spezifischen APIs mit 401-Fehlern fehl

• Empfehlung: Verwenden Sie Basic Auth für die Produktion, bis Upstream-Patches zusammengeführt wurden

Siehe docs/oauth-upstream-status.md für den Patch-Status und Workarounds.

Empfohlen: Basic Auth mit app-spezifischen Passwörtern bietet eine sichere, produktions