grooveseek

GrooveSeek는 Markdown 파일 지식 베이스에 대한 하이브리드 검색 — 시맨틱 및 전문 검색 — 을 위한 MCP 서버이며, 일반 텍스트, PDF, Office 문서 및 소스 코드는 선택적으로 사용할 수 있습니다. 명령은 `groove`입니다. 기본적으로 구성 파일 없이 기본 모델로 영어 Markdown과 YAML frontmatter를 인덱싱합니다. 다국어 또는 일본어 콘텐츠에는 `--model bge-m3`가 필요하며, 다른 모든 파일 형식은 `groove.toml`에서 활성화됩니다. 작동 방식: Markdown(그리고 선택적으로 .txt, .pdf, .docx, .xlsx, .pptx, v1.2.0부터 Rust 소스, v1.3.0부터 Python, v1.5.0부터 PHP — 해당 문법은 수동으로 다운로드하여 배치해야 함)은 YAML frontmatter와 함께 파싱되어 제목 기반 청크로 분할되며, 소스 코드의 경우 정의당 하나의 청크로 분할됩니다. 임베딩은 기본적으로 FastEmbed(BGE-small-en-v1.5, 다국어 지식 베이스의 경우 BGE-M3)로 생성되어 벡터 유사도 검색을 위해 sqlite-vec와 함께 SQLite에 저장됩니다. 신뢰할 수 있는 구성은 대신 OpenAI 호환 임베딩 엔드포인트를 선택할 수 있습니다. 클라이언트는 stdio(기본, 단일 클라이언트) 또는 Streamable HTTP(다중 클라이언트)를 통해 연결하므로 Claude Code, Cursor 또는 모든 MCP 호환 클라이언트와 작동합니다. 라이브 동기화 파일 감시자는 수동 편집, `git pull` 및 외부 스크립트에서 인덱스를 최신 상태로 유지합니다. 선택적 TOML 스키마는 `groove validate`를 통해 frontmatter 규칙을 검증할 수 있으며, v1.9.0부터 선언된 추가 키는 `groove index`에 의해 저장되어 `groove search --field`로 필터링할 수 있습니다. MCP 표면은 6개의 도구 — `search`, `get_document`, `list_topics`, `get_connection_graph`, `get_best_practice`, `rebuild_index` — 4개의 프롬프트, 그리고 `kb://` 리소스로서의 지식 베이스를 노출합니다. `--transport http`를 사용하면 서버는 `/ui`에서도 응답하며, 이 운영자 뷰는 버전, 문서 및 청크 수, 임베딩 모델, 감시자 상태, 가동 시간 및 pid를 표시하고 클라이언트가 사용하는 동일한 `/mcp` 엔드포인트를 통해 검색할 수 있습니다. 설치는 Linux x86_64 및 aarch64, macOS Apple Silicon 및 Windows x86_64용 사전 빌드된 바이너리를 통해 이루어지며, SHA-256 체크섬과 GitHub 아티팩트 증명이 제공됩니다. Intel Mac 빌드는 소스에서 빌드해야 합니다. ONNX 런타임과 SQLite는 정적으로 링크되며, 임베딩 모델은 첫 실행 시 HuggingFace에서 다운로드됩니다. 소스에서 빌드는 `cargo build --release`입니다. 빠른 시작은 `groove index --kb-path /path/to/knowledge-base`를 실행한 다음 `groove serve --kb-path ...`를 가리키는 `.mcp.json` 항목을 추가하거나, `groove search "..." --limit 3`으로 직접 쿼리하는 것입니다. 문서는 명령, 구성 키, 클라이언트 레시피, 검색 파이프라인(RRF, 재순위화, MMR, 부모 검색기), 필터, 바이트 오프셋이 있는 인용, 골든 쿼리 세트에 대한 평가, 아키텍처 및 안정성 보장을 다룹니다. 각 페이지의 일본어 버전이 제공되며 페이지는 사이트로 게시됩니다. 개인 stdio, NAS 공유 및 인트라넷 HTTP 설정을 위한 배포 레시피가 포함되어 있습니다. 1.0.0 이전 릴리스는 베타이며 호환성 보장이 없습니다. 1.0.0부터 안정성 문서는 무엇이 고정되었고 무엇이 의도적으로 고정되지 않았는지(웹 인터페이스 및 Rust API 포함)를 명시합니다. MIT 또는 Apache-2.0 이중 라이선스입니다.