航海者5号-MCP（或“海员5号-MCP”，具体翻译可能根据上下文调整，MCP通常指某种特定的系统或组件名称，此处未给出具体含义，故保留原英文缩写）
Mariner5 企业级搜索引擎能够完美控制的 基于Node.js的MCP（模型上下文协议）服务器是。
Java JNI本地支持 加号 REST API 回退（或“备用”）提供稳定且快速的性能。
主要功能
- 收藏管理模式、字段、查询管理（130+方法）
- 事先管理用户词典、停用词、同义词、文档排名（130+种方法）
- 索引控制索引构建、同步、备份/恢复（25+种方法）
- 服务器/日志运营账户、调度、访问控制、日志（70+种方法）
- 监测实时日志、性能分析、资源监控（60+种方法）
- 高级功能向量搜索、并集、戏剧、模拟（50+方法）
- 搜索优化SearchQueryBuilder，Analyzer设置，多级排序（60+方法）
- Java 扩展自动生成/编译/部署（5种类型）
- SQL 集成使用SQL查询自动创建集合
- 代码生成生成搜索网页Java源代码
🏗️ 系统架构
개발 환경 (Claude Code ↔ mariner5-mcp ↔ mariner5 엔진)
↓ 자동 생성/배포
실 환경 (Java 검색앱 또는 관리도구)- 开发Claude Code + mariner5-mcp 搜索索引自动管理
- 搜索Java 应用程序 + mariner5 REST API
- 管理Tomcat + webManager + mariner5 JNI（可译为：“Tomcat + webManager + mariner5 Java本地接口”）
安装
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（文件名或程序名，可译为“设置.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设置
- 设置。\*: 服务安装/运行管理（Derby/Search/REST/Tomcat）
- 网络管理员。\*：Tomcat管理工具自动设置
- collections.\*：创建/更新/删除/获取/列出
- columns.\* : 添加/更新/删除/列出
- queries.\* : 创建/更新/删除/列出/测试
- dict.\* : 推荐/重定向/停用词/用户中文/文档排名 (创建、读取、更新、删除)
- index.\* : 运行状态/状态，logs.index.get（获取索引日志）
- server.\* : 设置属性/健康状态
- logs.\* : error.get/error.delete/error.deleteAll 翻译为中文是：日志.\* : 获取错误/删除错误/删除所有错误
- sim.\*（模拟/仿真相关命令或操作）: 创建/更新/删除/列出/运行/状态
- \
ext.java.\*\: 创建/更新/删除/列出/激活/停用 - search.query : 执行搜索
- codegen.page.java.\* : 创建/预览/参数
测试示例
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