GeryonMCP

사내 Confluence 위키, Jira, Git 저장소를 로컬 SQLite에 적재해 오프라인으로 검색하는 MCP 서버입니다. 유료 API 호출 없이, CPU만으로, 인터넷도 필요 없이 동작합니다.

왜 만들었나
Claude Desktop 같은 MCP 클라이언트에 사내 문서를 연결하고 싶은데, 외부 SaaS나 GPU 서버를 쓸 수 없는 환경(보안·비용·폐쇄망)이 많습니다. 벡터 DB 도입도 부담이 크고, 단순 키워드 검색은 정확도가 낮았습니다.

검색 방식

• BM25(FTS5) 키워드 검색으로 후보를 추리고
• ONNX int8 cross-encoder로 재정렬 — 정확도의 핵심
• 제목과 본문 구절을 함께 평가(best-passage)해 본문에만 답이 있는 문서도 회복
• 벡터 검색 없이 87% hit@top5 달성 (Confluence 29,000문서 / 31개 골든 질의 기준)

특징

• Confluence 공식 siteSearch 대비 +7pp(87% vs 80%), 오프라인·무료
• 한국어·영어 다국어(조사 정규화, 음차 교차언어 매칭)
• Confluence + Jira + Git을 단일 rerank로 통합하는 멀티소스 federation
• 소스별 DB → 새 소스는 플러그인(검색 코드 변경 0)
• 증분 색인(변경분만 재색인, API 재호출 0)
• 메달리온 아키텍처: 원본 보존(Bronze) → 정제 DB(Silver) → 동의어 사전(Gold)
• 폐쇄망(air-gap) 완전 지원 — 오프라인 휠 번들·모델 반입 가이드 포함
• MCP 도구: search / advanced_search / get_document / get_related / browse

설치

uv tool install .
geryon bootstrap   # 모델 1회 다운로드
geryon demo        # 자격증명 없이 체험
geryon serve       # MCP 서버 기동

Claude Desktop mcpServers에 geryon serve를 등록하면 끝.

메모리 16GB 이내 CPU 환경에서 검색 응답 ~1.5초(passage ON), ~700ms(passage OFF).