Lucene MCP Server

Wat doet de “Lucene” MCP Server?

De MCP Lucene Server is een Java-gebaseerde implementatie van het Model Context Protocol (MCP), ontworpen om efficiënte zoek- en ophaalfuncties te bieden met behulp van Apache Lucene. Als een MCP-conforme server stelt deze AI-assistenten en agents in staat om te werken met grote documentrepositories voor taken zoals full-text zoeken, indexeren en metadataselectie. Via de RESTful API kunnen clients documenten upserten (toevoegen/bijwerken), verwijderen, opsommen en opvragen met Lucene’s krachtige zoeksyntaxis. Gebouwd op Spring Boot is hij eenvoudig te implementeren en kan hij worden gecontaineriseerd met Docker. Deze server is ideaal voor het integreren van geavanceerde zoek- en beheerfuncties voor documenten in AI-gedreven workflows of softwareontwikkelingspijplijnen.

Lijst van Prompts

Geen informatie over prompt templates is beschikbaar in de repository.

Lijst van Resources

Er worden geen expliciete MCP resources beschreven in de repository.

Lijst van Tools

• Upsert Tool

  • Hiermee kunnen clients documenten toevoegen of bijwerken in de Lucene-index via het /mcp/v1/upsert endpoint.

• Delete Tool

  • Maakt het verwijderen van documenten uit de Lucene-index mogelijk via het /mcp/v1/delete endpoint.

• List Tool

  • Haalt een lijst met documenten uit de index op via het /mcp/v1/list endpoint.

• Query Tool

  • Ondersteunt complexe zoekopdrachten met de Lucene zoeksyntaxis via het /mcp/v1/query endpoint.

• Status Tool

  • Controleert de serverstatus via het /mcp/v1/status endpoint.

Gebruikstoepassingen van deze MCP Server

• Enterprise Document Search
  Ontwikkelaars kunnen de Lucene MCP Server integreren om robuuste, schaalbare zoekmogelijkheden te bieden over grote verzamelingen zakelijke documenten, zodat relevante bestanden en records eenvoudig gevonden kunnen worden.

• Kennisbankuitbreiding
  Breid AI-assistenten uit door ze informatie te laten opvragen uit geïndexeerde bedrijfsmanuals, FAQ’s of supporttickets.

• Geautomatiseerde gegevensinvoer en indexering
  Stroomlijn workflows door documenten programmatisch te upserten en bij te werken in de Lucene-index, zodat de zoekmachine altijd actueel is.

• Metadatagebaseerde filtering
  Profiteer van Lucene’s vermogen om zoekopdrachten te filteren op basis van documentmetadata, waardoor geavanceerde gegevensopvraging mogelijk wordt.

• API-gedreven zoekintegratie
  Maak naadloze toegang tot zoek- en beheerfuncties voor documenten mogelijk voor andere applicaties of agents via RESTful endpoints.

Hoe stel je het in

Windsurf

1. Zorg dat Java 11+ en Maven 3.6+ geïnstalleerd zijn.
2. Bouw het project:

   mvn clean install
   

3. Voeg de MCP Lucene Server toe aan je configuratie:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Sla je configuratie op en start Windsurf.
5. Controleer of de server draait op http://localhost:8080/mcp/v1/status.

Claude

1. Installeer Java 11+ en Maven 3.6+.
2. Bouw het project:

   mvn clean install
   

3. Bewerk je Claude-configuratie om het volgende op te nemen:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Herstart Claude en zorg dat de MCP Lucene Server bereikbaar is.

Cursor

1. Controleer of Java 11+ en Maven 3.6+ geïnstalleerd zijn.
2. Bouw de Lucene MCP Server:

   mvn clean install
   

3. Voeg toe aan je Cursor-configuratie:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Sla op en herstart Cursor.
5. Test het endpoint op http://localhost:8080/mcp/v1/status.

Cline

1. Zorg dat Java 11+ en Maven 3.6+ geïnstalleerd zijn.
2. Bouw:

   mvn clean install
   

3. In je Cline-configuratie:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Herstart Cline en controleer of de MCP server actief is.

Opmerking over het beveiligen van API-sleutels

Als je installatie vereist dat API-sleutels of gevoelige informatie beveiligd worden, gebruik dan omgevingsvariabelen:

{
  "mcpServers": {
    "lucene-mcp": {
      "command": "java",
      "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"],
      "env": {
        "LUCENE_API_KEY": "${LUCENE_API_KEY}"
      },
      "inputs": {
        "apiKey": "${LUCENE_API_KEY}"
      }
    }
  }
}

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, voeg je het MCP-component toe aan je flow en verbind je deze met je AI-agent:

Klik op het MCP-component om het configuratievenster te openen. Voeg in het systeem-MCP-configuratiegedeelte de details van je MCP-server in met dit JSON-formaat:

{
  "lucene-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Na configuratie kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “lucene-mcp” aan te passen naar de naam van jouw MCP-server en de URL te vervangen door je eigen MCP-server URL.

Overzicht

Op basis van de beschikbare informatie biedt de MCP Lucene Server een solide basis voor documentzoekopdrachten en -beheer, maar ontbreekt expliciete ondersteuning voor prompt templates, resources, roots of sampling. De documentatie voor installatie en gebruik als MCP-server is goed.

Onze mening

De MCP Lucene Server is een robuuste, praktische MCP-implementatie voor enterprise search en documentbeheer. Het ontbreken van prompt templates, resource-definities en geavanceerde MCP-functies zoals roots of sampling beperkt echter de flexibiliteit voor complexere, agentische workflows. Over het algemeen is het een goed startpunt voor het integreren van Lucene-gebaseerde zoekopdrachten in AI-systemen. MCP Score: 6/10

MCP Score