StevenStavrakis/obsidian-mcp
A simple MCP server for Obsidian
해결하는 문제
AI 어시스턴트가 Obsidian 백업을 안전하게 읽고 수정할 수 있도록 합니다. Obsidian 앱이 열려 있지 않아도 LLM 기반 도구가 개인 지식 기반과 상호작용할 수 있도록 다리 역할을 합니다.
작동 방식
이 프로젝트는 Model Context Protocol (MCP) 기반의 로컬 서버를 구현합니다. 파일 시스템에서 직접 Markdown 파일에 접근하여 Obsidian 백업에 연결합니다. 보안을 위해 허용된 백업 경로 목록을 명시적으로 사용하고, 모든 파일 경로를 엄격히 검증하여 시스템의 나머지 부분에 대한 비인가 접근을 방지합니다. 또한 파일 변경 사항을 트랜잭션 시스템으로 관리하여 변경 사항을 기록하고, etag를 사용해 충돌을 확인하며, 삭제되거나 수정된 노트를 복구할 수 있는 메커니즘을 제공합니다.
대상 사용자
노트를 자동으로 작성하고 검색하며 정리하고 싶은 Obsidian 사용자들로, MCP 호환 AI 어시스턴트와 통합하고자 하는 분들입니다.
주요 기능
- 트랜잭션 안정성: 파일 변경 사항은 기록되며 원자적으로 대체되며, 이전 버전을 복원할 수 있는 내장 복구 시스템이 있습니다.
- 포괄적인 도구 세트: 노트 읽기, 생성, 편집, 검색, 디렉터리 및 태그 관리 도구를 포함합니다.
- 스마트 링크 처리: 노트를 이동하거나 이름을 바꿀 때 위키링크, 임베드, Markdown 링크를 자동으로 업데이트합니다.
- 엄격한 보안: 심볼릭 링크를 차단하고 시스템 디렉터리를 예약하며, 유효하지 않은 경로를 거부하여 AI가 구성된 백업 외의 파일에 접근하지 못하도록 합니다.
- 프로토콜 호환성: 최신 및 구형 MCP 클라이언트 버전 모두와 호환됩니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트