Lucene MCP 서버

“Lucene” MCP 서버는 무엇을 하나요?

MCP Lucene 서버는 Apache Lucene을 활용한 Model Context Protocol(MCP) 기반의 Java 구현체로, 효율적인 검색 및 문서 조회 기능을 제공합니다. MCP 호환 서버로서, AI 어시스턴트 및 에이전트가 대규모 문서 저장소와 상호작용하여 전체 텍스트 검색, 인덱싱, 메타데이터 필터링 등의 작업을 수행할 수 있도록 해줍니다. RESTful API를 통해 Lucene의 강력한 쿼리 문법으로 문서의 추가/업데이트, 삭제, 목록 조회, 검색을 할 수 있습니다. Spring Boot 기반으로 쉽게 배포할 수 있으며, Docker로 컨테이너화도 지원합니다. 이 서버는 AI 기반 워크플로우나 소프트웨어 개발 파이프라인에 고급 문서 검색 및 관리 기능을 통합하는 데 이상적입니다.

프롬프트 목록

저장소에는 프롬프트 템플릿에 대한 정보가 제공되지 않습니다.

리소스 목록

저장소에는 명시적인 MCP 리소스가 설명되어 있지 않습니다.

도구 목록

• 업서트 도구

  • /mcp/v1/upsert 엔드포인트를 통해 Lucene 인덱스에 문서를 추가하거나 업데이트할 수 있습니다.

• 삭제 도구

  • /mcp/v1/delete 엔드포인트를 사용하여 Lucene 인덱스에서 문서를 삭제할 수 있습니다.

• 목록 도구

  • /mcp/v1/list 엔드포인트를 통해 인덱스에서 문서 목록을 조회합니다.

• 쿼리 도구

  • /mcp/v1/query 엔드포인트에서 Lucene 쿼리 문법을 활용한 복잡한 검색을 지원합니다.

• 상태 도구

  • /mcp/v1/status 엔드포인트를 통해 서버 상태를 확인할 수 있습니다.

이 MCP 서버의 활용 사례

• 엔터프라이즈 문서 검색
  개발자는 Lucene MCP 서버를 통합하여 대규모 비즈니스 문서에 대한 강력하고 확장 가능한 검색 기능을 제공할 수 있습니다. 이를 통해 관련 파일 및 기록을 쉽게 찾을 수 있습니다.

• 지식 베이스 강화
  AI 어시스턴트가 인덱싱된 사내 매뉴얼, FAQ, 지원 티켓에서 정보를 질의하고 검색할 수 있습니다.

• 자동 데이터 수집 및 인덱싱
  프로그램적으로 Lucene 인덱스에 문서를 추가/업데이트함으로써 검색 엔진이 항상 최신 상태를 유지하도록 워크플로우를 효율화합니다.

• 메타데이터 기반 필터링
  문서 메타데이터 기반의 쿼리 필터링을 통해 고급 데이터 검색 시나리오를 지원합니다.

• API 기반 검색 통합
  RESTful 엔드포인트를 통해 다른 애플리케이션이나 에이전트에서 문서 검색 및 관리 기능을 원활하게 사용할 수 있습니다.

설치 방법

Windsurf

1. Java 11 이상과 Maven 3.6 이상이 설치되어 있는지 확인하세요.
2. 프로젝트 빌드:

   mvn clean install
   

3. MCP Lucene 서버를 구성에 추가:

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

4. 구성을 저장하고 Windsurf를 시작하세요.
5. http://localhost:8080/mcp/v1/status에서 서버가 실행 중인지 확인합니다.

Claude

1. Java 11 이상과 Maven 3.6 이상을 설치하세요.
2. 프로젝트 빌드:

   mvn clean install
   

3. Claude 구성에 다음을 포함:

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

4. Claude를 재시작하고 MCP Lucene 서버가 연결 가능한지 확인하세요.

Cursor

1. Java 11 이상과 Maven 3.6 이상이 설치되어 있는지 확인하세요.
2. Lucene MCP 서버 빌드:

   mvn clean install
   

3. Cursor 구성에 추가:

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

4. 저장 후 Cursor를 재시작하세요.
5. http://localhost:8080/mcp/v1/status 엔드포인트 테스트.

Cline

1. Java 11 이상과 Maven 3.6 이상이 설치되어 있는지 확인하세요.
2. 빌드:

   mvn clean install
   

3. Cline 구성에 추가:

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

4. Cline을 재시작하고 MCP 서버가 활성화되었는지 확인하세요.

API 키 보안 관련 안내

설정에서 API 키나 민감한 정보를 안전하게 관리하려면 환경 변수를 사용하세요:

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

FlowHunt 내에서 MCP 사용 방법

FlowHunt에서 MCP 통합하기

MCP 서버를 FlowHunt 워크플로우에 통합하려면, 먼저 플로우에 MCP 컴포넌트를 추가하고 AI 에이전트에 연결하세요.

MCP 컴포넌트를 클릭해 구성 패널을 엽니다. 시스템 MCP 구성 섹션에 아래와 같은 JSON 형식으로 MCP 서버 정보를 입력하세요.

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

구성이 완료되면, AI 에이전트가 이 MCP를 도구로써 모든 기능과 역량에 접근할 수 있습니다. “lucene-mcp"를 실제 MCP 서버 이름으로, URL을 본인의 MCP 서버 주소로 반드시 변경하세요.

개요

제공된 정보를 기반으로, MCP Lucene 서버는 문서 검색 및 관리에 강력한 기반을 제공하지만, 프롬프트 템플릿, 리소스, Roots, 샘플링 등 명시적 지원은 부족합니다. MCP 서버로서의 설치와 사용에 관한 문서는 잘 갖춰져 있습니다.

의견

MCP Lucene 서버는 엔터프라이즈급 검색 및 문서 관리를 위한 견고하고 실용적인 MCP 구현체입니다. 다만, 프롬프트 템플릿, 리소스 정의, Roots나 샘플링 같은 고급 MCP 기능이 없어 복잡한 에이전트 워크플로우에는 유연성이 제한됩니다. 전반적으로 Lucene 기반 검색을 AI 시스템에 통합하는 출발점으로는 매우 훌륭합니다. MCP 점수: 6/10

MCP 점수