Welcome to Nextcloud MCP Server
Interactive user interface for semantic search and document retrieval. Test queries, visualize results, and explore your Nextcloud content using RAG workflows.
{{ auth_mode }}
About Semantic Search
This interface provides access to semantic search capabilities powered by vector embeddings. Unlike traditional keyword search, semantic search understands the meaning of your queries and finds conceptually similar content across your Nextcloud apps.
How it works:
- Documents from Notes, Calendar, Files, Contacts, and Deck are indexed into a vector database
- Each document chunk is converted to a 768-dimensional vector embedding that captures semantic meaning
- Queries are also converted to embeddings and matched against document vectors using similarity search
- Results can be retrieved using pure semantic search or hybrid BM25 search combining keywords and semantics
RAG Workflow Integration
This UI allows you to test the same queries that Large Language Models (LLMs) would use in a Retrieval-Augmented Generation (RAG) workflow. When an AI assistant needs to answer questions about your data:
- Step 1: The assistant converts your question into a search query
- Step 2: The MCP server retrieves relevant document chunks using semantic search
- Step 3: Retrieved context is passed to the LLM to generate an informed answer
benefits of coffee?"
Receives context,
generates answer
Sampling
BM25 Hybrid + RRF
with scores
with citations
for answer generation
Files, Contacts,
Deck
- User asks question through MCP Client
- Client sends query to MCP Server
- Server retrieves relevant document context from Nextcloud
- Server sends context back to Client's LLM (MCP Sampling)
- Client's LLM generates answer with citations using retrieved context
- Answer returned to user
Key Point: The MCP server retrieves context but doesn't generate answers itself. Through MCP sampling, it requests the client's LLM to generate responses, giving users full control over which model is used and ensuring all processing happens client-side.
By using this interface, you can preview search results, understand relevance scores, and verify that the system retrieves the right information before it reaches the LLM.
Available Features
User Information
View your authentication details, session information, and IdP profile. Manage background access permissions.
Vector Sync Status
Monitor real-time indexing progress with metrics for indexed documents, pending queue, and synchronization status.
Vector Visualization
Interactive search interface with 2D PCA visualization. Compare algorithms, view relevance scores, and explore matched document chunks.
Vector Sync is Disabled
Semantic search and vector visualization features are currently disabled.
To enable these features, set VECTOR_SYNC_ENABLED=true in your environment configuration.
Learn more: Configuration Guide
Available Features
{% endif %}Documentation
For detailed information about configuration, authentication modes, and advanced features, please refer to the project documentation:
- Installation Guide
- Configuration Options
- Authentication Modes {% if vector_sync_enabled %}
- Vector Sync UI Guide {% endif %}
User Information
{{ user_info_tab_html|safe }}Vector Sync Status
{{ vector_sync_tab_html|safe }}Vector Visualization
Loading vector visualization...