nextcloud-mcp-server
Verified Safeby cbcoutinho
Overview
A production-ready MCP server that connects AI assistants to your Nextcloud instance to enable interaction with Nextcloud data through natural language conversations.
Installation
docker run -p 127.0.0.1:8000:8000 --env-file .env --rm ghcr.io/cbcoutinho/nextcloud-mcp-server:latestEnvironment Variables
- NEXTCLOUD_HOST
- NEXTCLOUD_USERNAME
- NEXTCLOUD_PASSWORD
- RAG_EVAL_PROVIDER
- OLLAMA_HOST
- RAG_EVAL_OLLAMA_BASE_URL
- RAG_EVAL_OLLAMA_MODEL
- RAG_EVAL_ANTHROPIC_API_KEY
- RAG_EVAL_ANTHROPIC_MODEL
- VECTOR_SYNC_ENABLED
- VECTOR_SYNC_SCAN_INTERVAL
- VECTOR_SYNC_PROCESSOR_WORKERS
- QDRANT_LOCATION
- QDRANT_URL
- QDRANT_API_KEY
- OLLAMA_BASE_URL
- OLLAMA_EMBEDDING_MODEL
- OLLAMA_VERIFY_SSL
- DOCUMENT_CHUNK_SIZE
- DOCUMENT_CHUNK_OVERLAP
- OIDC_DISCOVERY_URL
- NEXTCLOUD_MCP_SERVER_URL
- NEXTCLOUD_RESOURCE_URI
- NEXTCLOUD_PUBLIC_ISSUER_URL
- NEXTCLOUD_OIDC_SCOPES
- ENABLE_OFFLINE_ACCESS
- TOKEN_ENCRYPTION_KEY
- TOKEN_STORAGE_DB
- ENABLE_TOKEN_EXCHANGE
- TOKEN_EXCHANGE_CACHE_TTL
- NEXTCLOUD_OIDC_CLIENT_ID
- NEXTCLOUD_OIDC_CLIENT_SECRET
- OIDC_JWKS_URI
- SMITHERY_DEPLOYMENT
- PORT
- LOG_FORMAT
- OTEL_SERVICE_NAME
- OTEL_EXPORTER_OTLP_ENDPOINT
Security Notes
The project is security-conscious, implementing OAuth2/OIDC, per-user tokens, and regular security assessments. However, the `docker-compose.yml` contains development-specific hardcoded secrets for `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD`, `NEXTCLOUD_ADMIN_PASSWORD`, and a default `QDRANT_API_KEY`, which are explicitly noted but could be misused if deployed to production without proper configuration. The `TOKEN_ENCRYPTION_KEY` is also hardcoded in the example. OAuth2/OIDC support is experimental and requires a manual patch to Nextcloud's `user_oidc` app, with Basic Auth recommended for production until upstream fixes are merged. No `eval` or obvious obfuscation found.
Similar Servers
advanced-homeassistant-mcp
A Model Context Protocol (MCP) server that enables AI assistants to seamlessly interact with Home Assistant for natural language smart home control.
php-mcp
Implements the Model Context Protocol (MCP) to enable seamless integration between LLM applications and external data sources and tools, providing a server-side framework in PHP.
openapi-mcp-server
Acts as a bridge to convert OpenAPI specifications into Model Context Protocol (MCP) tools, enabling AI assistants to interact with APIs.
photons
Photons are single-file TypeScript MCP servers designed to supercharge AI assistants with focused capabilities, providing a marketplace of tools for various domains like file operations, cloud integrations, and database management.