Obsidian Scoped-write MCP

지정된 Obsidian Vault에 접근하는 MCP 서비스입니다. Vault 전체는 읽을 수 있으며, Markdown 생성 및 업데이트는 ChatGPT 전용 디렉터리 두곳에서만 허용됩니다:

• 00-ChatGPT系统入口

• 01-ChatGPT策略主脑

삭제, 이동, 이름 변경 또는 Markdown이 아닌 쓰기 도구는 제공하지 않습니다.

도구

• list_directory：디렉터리를 나열합니다.

• read_markdown：Markdown을 읽습니다.

• search_markdown：Markdown을 검색합니다.

• get_file_info：크기, 수정 시간, SHA-256 및 쓰기 가능 여부를 확인합니다.

• create_directory：허용된 디렉터리 내에 1단계 일반 하위 폴더를 생성하며, 부모 디렉터리가 이미 존재해야 합니다.

• create_markdown：허용된 디렉터리에 새 파일을 생성하며, 덮어쓰기는 금지됩니다.

• update_markdown：예상 SHA-256을 사용하여 기존 파일을 업데이트하고, 업데이트 전에 Vault 외부에 백업합니다.

Related MCP server: Obsidian MCP Local

로컬 검증

npm ci
npm test

테스트는 기본적으로 임시 Vault와 임시 백업 디렉터리를 생성하며, 개인 Obsidian 데이터를 건드리지 않습니다. 실제 Vault 경로를 전달하면 읽기 테스트만 실행하고 쓰기는 실행하지 않습니다.

보안 경계

• 쓰기 디렉터리는 서버 측 고정 화이트리스트로 제어되므로 도구 매개변수로 범위를 넓힐 수 없습니다.

• 폴더 생성은 1단계 작업만 허용됩니다. 동일한 이름, 숨김 디렉터리, 부모 디렉터리 누락, 범위 이탈 및 심볼릭 링크 탈출은 모두 거부됩니다.

• 생성 대상이 이미 존재하면 거부됩니다.

• 업데이트 전에 먼저 get_file_info를 호출하고, 반환된 sha256을 expected_sha256으로 사용합니다. 기존 파일이 변경된 경우 업데이트가 거부됩니다.

• 업데이트 전에 현재 Windows 사용자의 로컬 앱 데이터 디렉터리에 백업합니다. 백업은 Vault와 Git 저장소에 포함되지 않습니다.

• 절대 경로, 범위를 벗어난 경로, 심볼릭 링크 탈출 및 Markdown이 아닌 것은 모두 거부됩니다.

개발 프로세스

• main은 항상 배포 가능한 상태를 유지합니다.

• 모든 저장소 변경은 단기 수명 브랜치와 Pull Request를 사용합니다.

• CI가 통과한 후에만 병합하며, 기본적으로 squash merge를 사용합니다.

• 아키텍처, 보안 경계, 데이터 형식, 장기 의존성 또는 여러 개의 독립된 PR을 포함하는 큰 기능: 부모 Issue, Sub-issues, ADR, PR, CI 및 롤백 기록을 사용합니다.

• 긴급 패치: 단일 Issue 또는 PR, 최소한의 변경, 최소한의 테스트 및 롤백 설명을 사용합니다.

거버너스 패치 수락

• 수락: npm test을 실행하고 Pull Request의 CI 검사가 통과된 후에 병합합니다.

• 롤백: GitHub에서 해당 squash commit을 되돌립니다.