Servidor Lucene MCP

O que faz o Servidor “Lucene” MCP?

O Servidor MCP Lucene é uma implementação Java do Model Context Protocol (MCP) projetada para fornecer capacidades eficientes de busca e recuperação usando o Apache Lucene. Atuando como um servidor compatível com MCP, permite que assistentes e agentes de IA interajam com grandes repositórios de documentos para tarefas como busca textual completa, indexação e filtragem por metadados. Por meio de sua API RESTful, o Servidor Lucene MCP permite que clientes façam upsert (adicionem/atualizem), deletem, listem e consultem documentos usando a poderosa sintaxe de consulta do Lucene. Construído sobre Spring Boot, é fácil de implantar e pode ser containerizado com Docker. Este servidor é ideal para integrar recursos avançados de busca e gestão de documentos em fluxos de trabalho orientados por IA ou pipelines de desenvolvimento de software.

Lista de Prompts

Nenhuma informação sobre templates de prompt é fornecida no repositório.

Lista de Recursos

Nenhum recurso MCP explícito é descrito no repositório.

Lista de Ferramentas

• Ferramenta de Upsert

  • Permite que clientes adicionem ou atualizem documentos no índice Lucene através do endpoint /mcp/v1/upsert.

• Ferramenta de Delete

  • Possibilita a exclusão de documentos do índice Lucene usando o endpoint /mcp/v1/delete.

• Ferramenta de List

  • Recupera uma lista de documentos do índice via endpoint /mcp/v1/list.

• Ferramenta de Query

  • Suporta consultas complexas com a sintaxe de consulta do Lucene usando o endpoint /mcp/v1/query.

• Ferramenta de Status

  • Verifica o status do servidor com o endpoint /mcp/v1/status.

Casos de uso deste Servidor MCP

• Busca Empresarial de Documentos
  Desenvolvedores podem integrar o Servidor Lucene MCP para fornecer capacidades robustas e escaláveis de busca em grandes conjuntos de documentos corporativos, facilitando encontrar arquivos e registros relevantes.

• Enriquecimento de Base de Conhecimento
  Potencialize assistentes de IA permitindo que consultem e recuperem informações de manuais, FAQs ou tickets de suporte indexados da empresa.

• Ingestão e Indexação Automatizadas de Dados
  Otimize fluxos de trabalho ao fazer upsert e atualização programática de documentos no índice Lucene, garantindo que o mecanismo de busca esteja sempre atualizado.

• Filtragem Baseada em Metadados
  Aproveite a capacidade do Lucene de filtrar consultas com base em metadados dos documentos, suportando cenários avançados de recuperação de dados.

• Integração de Busca via API
  Facilite o acesso fluido a recursos de busca e gestão de documentos para outros aplicativos ou agentes via endpoints RESTful.

Como configurar

Windsurf

1. Certifique-se de que Java 11+ e Maven 3.6+ estão instalados.
2. Compile o projeto:

   mvn clean install
   

3. Adicione o Servidor MCP Lucene à sua configuração:

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

4. Salve sua configuração e inicie o Windsurf.
5. Verifique se o servidor está rodando em http://localhost:8080/mcp/v1/status.

Claude

1. Instale Java 11+ e Maven 3.6+.
2. Compile o projeto:

   mvn clean install
   

3. Edite sua configuração do Claude para incluir:

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

4. Reinicie o Claude e certifique-se de que o Servidor MCP Lucene está acessível.

Cursor

1. Confirme que Java 11+ e Maven 3.6+ estão instalados.
2. Compile o Servidor Lucene MCP:

   mvn clean install
   

3. Adicione à sua configuração do Cursor:

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

4. Salve e reinicie o Cursor.
5. Teste o endpoint em http://localhost:8080/mcp/v1/status.

Cline

1. Certifique-se de que Java 11+ e Maven 3.6+ estão instalados.
2. Compile:

   mvn clean install
   

3. Na sua configuração do Cline:

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

4. Reinicie o Cline e confirme que o servidor MCP está ativo.

Observação sobre segurança de chaves de API

Se sua configuração exige proteger chaves de API ou informações sensíveis, utilize variáveis de ambiente:

{
  "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}"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

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

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de trocar “lucene-mcp” pelo nome real do seu servidor MCP e substituir a URL pela URL do seu próprio servidor MCP.

Visão geral

Com base nas informações disponíveis, o Servidor MCP Lucene oferece uma base sólida para busca e gestão de documentos, mas não possui suporte explícito a templates de prompt, recursos, roots ou amostragem. Sua documentação para configuração e uso como servidor MCP é completa.

Nossa opinião

O Servidor MCP Lucene é uma implementação MCP robusta e prática para busca e gestão de documentos em nível empresarial. Contudo, a ausência de templates de prompt, definições de recursos e recursos MCP avançados como roots ou amostragem limita sua flexibilidade para fluxos de trabalho mais complexos e agentivos. No geral, é um ponto de partida sólido para integrar busca baseada em Lucene a sistemas de IA. Pontuação MCP: 6/10

Pontuação MCP