bitbonsai/mcpvault
A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access
해결하는 문제
MCPVault를 사용하면 AI 어시스턴트가 로컬 Obsidian 볼트와 직접 상호 작용할 수 있습니다. AI 클라이언트와 사용자의 개인 지식 베이스 간의 간극을 연결하여, Obsidian 애플리케이션을 실행하거나 특정 Obsidian 플러그인을 설치할 필요 없이 AI가 노트를 읽고, 검색하고, 편집할 수 있도록 합니다.
작동 방식
로컬 Model Context Protocol (MCP) 서버로 작동합니다. AI 클라이언트(예: Claude Desktop 또는 Cursor)가 stdio 프로세스로 서버를 시작하면, MCPVault는 AI가 파일 시스템 작업을 수행하기 위해 호출할 수 있는 일련의 도구를 제공합니다. 볼트의 마크다운 파일과 직접 상호 작용하며 AST 인식 업데이트를 사용하여 frontmatter를 편집할 때 변경되지 않은 다른 필드의 서식이 유지되도록 합니다.
대상 사용자
연구 요약, 태그 관리 또는 기존 노트를 기반으로 새 콘텐츠 작성과 같은 작업을 위해 개인 노트와 지식 베이스를 AI 에이전트 및 LLM 클라이언트와 통합하려는 Obsidian 사용자.
주요 기능
- 포괄적인 도구 세트: 노트 읽기, 쓰기, 패치, 삭제 및 이동은 물론 태그 및 frontmatter 관리를 포함한 작업을 위한 18개의 도구를 제공합니다.
- 고급 검색: 더 관련성 높은 검색 결과를 위해 다단어 매칭 및 BM25 재랭킹 기능을 제공합니다.
- 보안 중심: 디렉토리 순회, 심볼릭 링크 이스케이프 및
.obsidian또는.git과 같은 민감한 폴더에 대한 액세스를 차단하기 위해 엄격한 경로 검사를 구현합니다. - 유연한 쓰기 모드: 노트에 콘텐츠를 추가하기 위한 덮어쓰기, 추가 및 앞에 추가(prepend) 모드를 지원합니다.
- 폭넓은 호환성: Claude Desktop, ChatGPT Desktop (Enterprise+), Cursor 및 Windsurf를 포함한 MCP 호환 클라이언트와 함께 작동합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트