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 both STDIO transport (for Claude Desktop integration) and HTTP transport (for. Exposed over MCP by the mcpluceneserver mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

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.)

Its toolset

Everything the assistant can do here goes through one of these:

  • Prerequisites — The Prerequisites tool exposed by this server
  • simpleSearch — Search the Lucene fulltext index using plain text keyword search. Special characters are treated as literals — no Lucene syntax knowledge required
  • extendedSearch — Search the Lucene fulltext index using full Lucene query syntax. Supports Boolean operators, wildcards, proximity queries, and field-specific
  • semanticSearch — Pure KNN embedding-based semantic search. Finds semantically related documents even without exact keyword matches. Results are ordered by cosine
  • profileSemanticSearch — Debug tool for semantic search. Shows embedding time, cosine scores, matched chunks, and how many candidates passed the similarity threshold. Use
  • profileQuery — Analyze and debug simpleSearch / extendedSearch queries. Provides detailed insights into how Lucene processes your query, which terms contribute to

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at mirkosertic42/mcpluceneserver on a container image and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration

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

When to reach for it

Among the AI and media services options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Mcpluceneserver's toolset — Prerequisites, simpleSearch, extendedSearch and 3 more — is a fair guide to whether it matches your workflow. It is maintained by mirkosertic; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Mcpluceneserver's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcpluceneserver mcp server does with a few real requests.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
simpleSearchSearch 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.
extendedSearchSearch 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.
semanticSearchPure 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.
profileSemanticSearchDebug 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.
profileQueryAnalyze 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

It connects Mcpluceneserver to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Prerequisites, simpleSearch, extendedSearch, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Mcpluceneserver directly.