mariner5-mcp

Mariner5 기업형 검색엔진을 완벽하게 제어할 수 있는 Node.js 기반 MCP(Model Context Protocol) 서버입니다.

Java JNI 네이티브 지원 + REST API 폴백으로 안정적이고 빠른 성능을 제공합니다.

주요 기능

• 컬렉션 관리: 스키마, 필드, 쿼리 관리 (130+ 메서드)
• 사전 관리: 사용자사전, 불용어, 유의어, 문서랭킹 (130+ 메서드)
• 색인 제어: 색인 빌드, 동기화, 백업/복구 (25+ 메서드)
• 서버/로그 운영: 계정, 스케줄, 접속 제어, 로그 (70+ 메서드)
• 모니터링: 실시간 로그, 성능 분석, 리소스 모니터링 (60+ 메서드)
• 고급 기능: Vector Search, Union, Drama, 시뮬레이션 (50+ 메서드)
• 검색 튜닝: SearchQueryBuilder, Analyzer 설정, 다단계 정렬 (60+ 메서드)
• Java Extension: 자동 생성/컴파일/배포 (5가지 유형)
• SQL 통합: SQL 쿼리로 자동 컬렉션 생성
• 코드 생성: 검색 웹페이지 Java 소스 생성

🏗️ 시스템 아키텍처

개발 환경 (Claude Code ↔ mariner5-mcp ↔ mariner5 엔진)
   ↓ 자동 생성/배포
실 환경 (Java 검색앱 또는 관리도구)

자세한 내용: ARCHITECTURE.md

• 개발: Claude Code + mariner5-mcp로 검색 인덱스 자동 관리
• 검색: Java 애플리케이션 + mariner5 REST API
• 관리: Tomcat + webManager + mariner5 JNI

설치

npm i
cp .env.example .env
# .env의 MARINER5_HOME, BASE_URL을 실제 환경에 맞게 설정

실행 (stdin/stdout JSON-RPC)

npm start

• 한 줄에 하나의 JSON 요청을 쓰면, 한 줄에 응답이 돌아옵니다.
• 예시:

{"id":1,"method":"collections.list","params":{}}

주요 환경변수

# mariner5 연결 (필수)
MARINER5_HOME=C:\DATA\Project\mariner5   # 설치 경로
MARINER5_HOST=localhost                   # AdminServer 호스트
MARINER5_PORT=5555                        # AdminServer 포트

# REST API 폴백 (선택)
BASE_URL=http://localhost:8080/api
API_TOKEN=                                # 인증 토큰 (없으면 생략)
HTTP_TIMEOUT=60000                        # 밀리초

# 로그
LOG_LEVEL=info                            # debug|info|warn|error

제공 도구(메서드명)

• setup.mpc.*: Java 감지, RDBMS 선택, 설정 파일 자동 생성 (MPC 도구) ⭐ 신규
  • setup.mpc.detectJava: Java 자동 감지
  • setup.mpc.listRdbms: 7가지 RDBMS 템플릿 목록
  • setup.mpc.configure: startup.properties + ir.rdbms.properties 자동 생성
  • setup.mpc.verify: Mariner5 설정 검증
• setup.*: 서비스 설치/구동 관리 (Derby/Search/REST/Tomcat)
• webmanager.*: Tomcat 관리도구 자동 설정
• collections.* : create/update/delete/get/list
• columns.* : add/update/delete/list
• queries.* : create/update/delete/list/test
• dict.* : recommend/redirect/stopword/userCn/documentRanking (CRUD)
• index.* : run/status, logs.index.get
• server.* : setProps/health
• logs.* : error.get/error.delete/error.deleteAll
• sim.* : create/update/delete/list/run/status
• ext.java.* : create/update/delete/list/activate/deactivate
• search.query : 검색 실행
• codegen.page.java.* : create/preview/params

테스트 예시

MPC 도구 (Mariner5 자동 설정) ⭐ 신규

# 1) Java 자동 감지
echo '{"id":1,"method":"setup.mpc.detectJava","params":{}}' | npm start

# 2) RDBMS 템플릿 목록 (Derby, MySQL, Oracle 등 7가지)
echo '{"id":2,"method":"setup.mpc.listRdbms","params":{}}' | npm start

# 3) Mariner5 자동 설정 (startup.properties + ir.rdbms.properties 생성)
echo '{"id":3,"method":"setup.mpc.configure","params":{"mariner5Home":"C:\\DATA\\Project\\mariner5","rdbmsType":"derby","debug":false}}' | npm start

# 4) 설정 검증
echo '{"id":4,"method":"setup.mpc.verify","params":{"mariner5Home":"C:\\DATA\\Project\\mariner5"}}' | npm start

기본 도구

# 1) 검색
echo '{ "id":1, "method":"search.query", "params":{"querySet":{"version":"1.0","query":[{"fromSet":{"collection":["demo"]},"selectSet":{"fields":["*"]},"whereSet":{"operator":"AND","searchKeyword":"테스트"}}]}} }' | npm start

# 2) 색인 실행
echo '{ "id":2, "method":"index.run", "params":{"collection":"demo","type":"rebuild"} }' | npm start

# 3) 컬럼 추가
echo '{ "id":3, "method":"columns.add", "params":{"collection":"demo","field":"title","type":"text","analyzer":"korean"} }' | npm start