링크된 문서
obsidian-mcp
obsidian-mcp
obsidian-mcp는 Obsidian 볼트와 상호작용할 수 있게 해주는 MCP(Model Context Protocol) 서버로, 메모 검색, 읽기, 쓰기 및 구성을 위한 도구를 제공합니다. 인공지능 어시스턴트가 자연어를 통해 사용자의 Obsidian 볼트에 접근하고 관리할 수 있도록 합니다.
특징
- 노트 읽기 및 검색: 볼트 내 노트 읽기 및 검색 기능
- 노트 생성 및 편집: 새 노트 생성 및 기존 노트 편집 기능
- 디렉토리 관리: 디렉토리 생성 및 관리 기능
- 노트 이동 및 삭제: 노트 위치 변경 및 삭제 기능
- 태그 관리: 태그 추가, 제거, 이름 변경 등의 기능
- 다중 볼트 지원: 여러 Obsidian 볼트 관리 기능
API
도구
read-note
노트 내용을 읽는 도구입니다.
- 입력:
- vault: 볼트 이름
- filename: 노트 파일명
- folder: (선택 사항) 볼트 루트에 대한 하위 폴더 경로
create-note
새 노트를 생성하는 도구입니다.
- 입력:
- vault: 볼트 이름
- filename: 노트 파일명
- content: 마크다운 형식의 노트 내용
- folder: (선택 사항) 볼트 루트에 대한 하위 폴더 경로
edit-note
기존 노트를 편집하는 도구입니다.
- 입력:
- vault: 볼트 이름
- filename: 노트 파일명
- content: 새 내용
- operation: 작업 유형 (append, prepend, replace)
- folder: (선택 사항) 볼트 루트에 대한 하위 폴더 경로
delete-note
노트를 삭제하는 도구입니다.
- 입력:
- vault: 볼트 이름
- path: 볼트 루트에 대한 노트 경로
- permanent: (선택 사항) 영구 삭제 여부, 기본값 false
move-note
노트를 다른 위치로 이동하는 도구입니다.
- 입력:
- vault: 볼트 이름
- source: 소스 경로
- destination: 목적지 경로
create-directory
새 디렉토리를 생성하는 도구입니다.
- 입력:
- vault: 볼트 이름
- path: 생성할 디렉토리 경로
- recursive: (선택 사항) 부모 디렉토리 생성 여부, 기본값 true
search-vault
볼트에서 노트를 검색하는 도구입니다.
- 입력:
- vault: 볼트 이름
- query: 검색어
- searchType: (선택 사항) 검색 유형 (content, filename, both)
- path: (선택 사항) 검색 범위를 제한할 하위 폴더 경로
- caseSensitive: (선택 사항) 대소문자 구분 여부
add-tags
노트에 태그를 추가하는 도구입니다.
- 입력:
- vault: 볼트 이름
- files: 처리할 노트 파일명 배열
- tags: 추가할 태그 배열
- location: (선택 사항) 태그를 추가할 위치 (frontmatter, content, both)
- position: (선택 사항) 인라인 태그 위치 (start, end)
remove-tags
노트에서 태그를 제거하는 도구입니다.
- 입력:
- vault: 볼트 이름
- files: 처리할 노트 파일명 배열
- tags: 제거할 태그 배열
- options: (선택 사항) 추가 옵션
rename-tag
모든 노트에서 태그의 이름을 변경하는 도구입니다.
- 입력:
- vault: 볼트 이름
- oldTag: 이전 태그 이름
- newTag: 새 태그 이름
- normalize: (선택 사항) 태그 이름 정규화 여부, 기본값 true
- createBackup: (선택 사항) 백업 생성 여부, 기본값 true
list-available-vaults
사용 가능한 모든 볼트를 나열하는 도구입니다. - 입력: 없음
사용 방법
설치
도구는 Node.js 20 이상이 필요합니다. Claude Desktop 구성 파일에 서버를 추가하여 설치합니다:
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": [
"-y",
"obsidian-mcp",
"/path/to/your/vault",
"/path/to/your/vault2"
]
}
}
}보안 고려 사항
- 이 서버는 Obsidian 볼트 디렉토리에 대한 접근 권한이 필요합니다.
- 서버 구성 시 의도한 볼트 디렉토리에만 접근 권한을 제공하도록 해야 합니다.
- 도구 작업을 승인하기 전에 검토하는 것이 좋습니다.