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.

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)

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

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