Overview
The MCP Lucene Server is a Java-based implementation of the Model Context Protocol (MCP) built with Spring Boot and Apache Lucene. It provides MCP-compliant document search and retrieval by indexing documents with Lucene and exposing a RESTful API to manage the index. Core capabilities include upserting documents (insert or update), deleting by IDs, and listing documents in the index. It supports complex queries using Lucene's syntax, with optional metadata filters (e.g., language, category), and supports returning top-k results. The API is available under /mcp/v1 with endpoints for status, upsert, query, delete, and list. The Lucene index directory path is configurable via lucene.index.path, and the server port via server.port (default 8080). The project supports running as a standalone Spring Boot application or via Docker. An optional MCP shim (mcp-shim) enables exposing endpoints as MCP tools over STDIO for Claude Desktop, with configuration guidance for Claude. The solution focuses on fast search, document management, and MCP-compatible access to indexed data with straightforward deployment.
Features
MCP Compliance
Implements the core Model Context Protocol (MCP) to provide MCP-compatible access to indexed documents.
Lucene-Powered
Utilizes Apache Lucene for fast full-text search and indexing of documents.
RESTful API
Exposes a REST API for status, upsert, delete, list, and query operations against the index.
Document Management
Supports upsert (insert/update), delete, and list operations to manage documents in the Lucene index.
Querying
Allows complex queries using Lucene syntax with optional metadata filters and top_k results.
Status
Provides an endpoint to check the server and index status.
Spring Boot
Built with Spring Boot for easy setup, configuration, and deployment.
Dockerization
Includes Docker support and instructions to containerize and run the application.
