coddingtonbear/obsidian-local-rest-api

해결하는 문제

이 프로젝트는 Obsidian을 위한 안전하고 인증된 REST API 및 MCP (Model Context Protocol) 서버를 제공하여, 외부 스크립트, 브라우저 확장 프로그램 및 AI 에이전트가 프로그래밍 방식으로 Obsidian 볼트와 상호 작용할 수 있도록 합니다.

작동 방식

로컬 서버를 호스팅하는 Obsidian 플러그인으로 작동합니다. 표준 HTTP 요청을 위한 REST API와 AI 에이전트를 위한 내장 MCP 서버를 노출합니다. 두 인터페이스 모두 동일한 핵심 기능을 제공하며, 볼트 파일에 대한 전체 CRUD 작업, 특정 노트 섹션(제목, 블록 또는 frontmatter)에 대한 정밀한 패치 적용, Obsidian 명령어 실행, 그리고 전체 텍스트 또는 구조화된 JsonLogic 쿼리를 사용한 볼트 검색 기능을 포함합니다.

대상 사용자

• 개발자: Obsidian 볼트 관리를 자동화하기 위해 스크립트나 브라우저 확장 프로그램을 만드는 분.
• AI 에이전트 사용자: LLM 기반 도구(Claude Code, Claude Desktop, Cursor 등)를 개인 지식 베이스에 직접 연결하려는 분.

주요 특징

• 정밀 패치 (Surgical Patching): 파일 전체를 다시 쓰지 않고도 노트의 특정 섹션을 편집(추가, 앞에 삽입, 교체 또는 삭제)할 수 있습니다.
• MCP 통합: Model Context Protocol을 기본 지원하여 AI 에이전트가 볼트를 읽고 쓸 수 있습니다.
• 볼트 이벤트: Server-Sent Events 스트림을 통해 볼트 변경 사항(노트 생성, frontmatter 변경 등)을 구독할 수 있습니다.
• 보안 액세스: 모든 요청은 로컬에서 생성된 인증서와 API 키 인증을 사용하여 HTTPS를 통해 제공됩니다.
• 확장 가능한 API: 다른 플러그인은 확장 인터페이스를 통해 자체 사용자 지정 경로를 등록할 수 있습니다.