How do I install the mcpluceneserver mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Mcpluceneserver MCP Server

A Model Context Protocol (MCP) server that exposes Apache Lucene fulltext search capabilities with automatic document crawling and indexing. This

Local serverstdioGo

What is the Mcpluceneserver MCP Server?

A Model Context Protocol (MCP) server that exposes Apache Lucene fulltext search capabilities with automatic document crawling and indexing. This server supports

What it actually does

Automatically indexes PDFs, Microsoft Office, and OpenOffice documents
Multi-threaded crawling for fast indexing
Real-time directory monitoring for automatic updates
Incremental indexing with full reconciliation (skips unchanged files, removes orphans)
Simple keyword search (no Lucene syntax needed) and full Lucene query syntax search
Field-specific filtering (by author, language, file type, etc.)

Configuration

Java 25 or later - Required to run the server - Maven 3.9+ (only if building from source)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
simpleSearch	Search the Lucene fulltext index using plain text keyword search. Special characters are treated as literals — no Lucene syntax knowledge required. Uses BM25 with German and English stemming.
extendedSearch	Search the Lucene fulltext index using full Lucene query syntax. Supports Boolean operators, wildcards, proximity queries, and field-specific queries. Uses BM25 with German and English stemming.
semanticSearch	Pure KNN embedding-based semantic search. Finds semantically related documents even without exact keyword matches. Results are ordered by cosine similarity. Requires VECTOR_MODEL to be configured.
profileSemanticSearch	Debug tool for semantic search. Shows embedding time, cosine scores, matched chunks, and how many candidates passed the similarity threshold. Use this to tune similarityThreshold for your data.
profileQuery	Analyze and debug simpleSearch / extendedSearch queries. Provides detailed insights into how Lucene processes your query, which terms contribute to scoring, how filters affect results, and where optimization opportunitie

How to install the Mcpluceneserver MCP Server

{
  "mcpServers": {
    "mcpluceneserver": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mirkosertic42/mcpluceneserver"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Java 25 or later - Required to run the server - Maven 3.9+ (only if building from source)

Example prompts to try

“Use Mcpluceneserver to Prerequisites.”
“Use Mcpluceneserver to simpleSearch.”
“Use Mcpluceneserver to extendedSearch.”

Frequently asked questions

A Model Context Protocol (MCP) server that exposes Apache Lucene fulltext search capabilities with automatic document crawling and indexing. This server supports Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.