vault-cortex

Vault Cortex는 AI 에이전트에 하이브리드 검색, 작업 관리, 구조화 메모리, Obsidian 볼트 읽기/쓰기 액세스를 제공하는 독립형 MCP(Model Context Protocol) 서버입니다. 디스크의 `.md` 파일에서 직접 작동하며, Obsidian 플러그인이나 실행 중인 인스턴스가 필요하지 않습니다. 서버는 단일 Docker 컨테이너로 실행되며, 로컬 배포, VPS 자체 호스팅, 또는 Railway나 Render에서 원격 액세스를 위한 원클릭 배포가 가능합니다. **주요 기능:** - **하이브리드 검색**: Reciprocal Rank Fusion(RRF)을 통한 FTS5 키워드 매칭과 벡터 의미 유사성 결합, 의도 중심 쿼리에 대해 교차 인코더 재순위화로 정제. 모든 모델은 로컬에서 실행(~45MB 총, 외부 API 없음). - **구조화 메모리**: 일반 Markdown 파일(기본 `About Me/` 폴더)에 저장된 추가 전용, 날짜별 항목 시스템. 주제 회상은 모든 메모리 파일에서 관련 항목을 검색하여 현재 상태와 과거 변화를 표시. 정리 가능한 현재 상태 항목에 대한 `entry-policy: living` 지원. - **작업 관리**: 칸반 인식 작업 쿼리 및 업데이트. 상태, 날짜, 우선순위, 폴더, 또는 레인별 필터링 지원. Tasks 플러그인 이모지 표시자와 Dataview 인라인 필드 형식을 모두 처리. 반복 작업 완료 시 다음 발생 항목 생성, "완료 시" 작업 지원. - **파일 액세스**: 이미지(서버 측 축소), PDF(텍스트 추출 또는 렌더링 페이지), 캔버스(읽기 가능한 개요), 데이터 파일(TXT, SVG, JSON, XML, CSV, YAML, 로그, Bases)을 포함한 비마크다운 파일 읽기. - **링크 그래프**: 볼트 전체의 역링크, 나가는 링크, 고아 문서 감지. - **Obsidian 네이티브**: frontmatter, wikilink, 태그, 제목, 일일 노트 이해. - **가이드 워크플로우**: 볼트 상태, 메모리 검토, 일일 조정을 위한 내장 프롬프트, 실시간 볼트 데이터로 구성. **인증**: 동의 페이지가 있는 원격 액세스용 OAuth 2.1 지원, OAuth 없는 클라이언트용 Bearer 토큰 지원. OAuth 클라이언트의 토큰 갱신은 자동 처리. **배포 옵션:** - 로컬: Docker + 볼트 폴더, `npx vault-cortex@latest init`으로 설정 - 원격: Railway 또는 Render에 원클릭 배포, 또는 Docker가 있는 Linux VPS 자체 호스팅 - 원격 배포는 Obsidian Sync를 사용하여 여러 기기에서 볼트를 최신 상태로 유지 **설정**: CLI가 서버 수명 주기(`configure`, `upgrade`, `start`, `restart`, `logs`, `down`)를 관리. 수동 Docker Compose 설정도 가능. `/setup` 페이지에서 원격 배포용 Obsidian Sync 로그인 처리. **보안**: Gitleaks 및 Trivy 스캔, OpenSSF Scorecard 및 Best Practices 배지가 포함된 CI 포함. 볼트는 일반 Markdown에서 진실의 원천으로 유지, 컨테이너는 사본만 보유. **사용 사례**: 유럽 15일 여행 동안 휴대폰에서 30개 이상 세션, 216회 도구 호출, 노트북 액세스 없이 테스트. 한 세션의 쓰기는 다음 세션에서 도시와 날짜를 넘어 즉시 사용 가능.