흑요석 MCP 서버
AI 어시스턴트가 Obsidian 볼트와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버로, 노트와 태그를 읽고, 만들고, 편집하고, 관리할 수 있는 도구를 제공합니다.
경고!!!
이 MCP는 읽기 및 쓰기 권한이 있습니다(허용하는 경우). obsidian-mcp를 사용하여 노트를 관리하기 전에 Obsidian 볼트를 백업해 주세요. git 사용을 권장하지만, 어떤 백업 방법이든 괜찮습니다. 이러한 도구들은 테스트되었지만 아직 완전히 테스트되지 않았으며, 이 MCP는 현재 개발 중입니다.
Related MCP server: Obsidian MCP Server
특징
보관소에서 메모를 읽고 검색하세요
새로운 메모와 디렉토리 만들기
기존 노트 편집
메모 이동 및 삭제
태그 관리(추가, 제거, 이름 변경)
보관함 내용 검색
요구 사항
Node.js 20 이상(더 낮은 버전에서도 작동할 수 있지만 테스트하지 않았습니다)
흑요석 금고
설치하다
수동 설치
Claude Desktop 구성에 다음을 추가합니다.
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
지엑스피1
/path/to/your/vault Obsidian 볼트의 절대 경로로 바꾸세요. 예:
MacOS/리눅스:
윈도우:
구성을 저장한 후 Claude for Desktop을 다시 시작하세요. 서버가 연결되었음을 나타내는 망치 아이콘이 나타납니다.
연결 문제가 있는 경우 다음 위치에서 로그를 확인하세요.
MacOS:
~/Library/Logs/Claude/mcp*.logWindows:
%APPDATA%\Claude\logs\mcp*.log
Smithery를 통해 설치
경고: 저는 Smithery와 아무런 관련이 없습니다. 직접 사용해 보지도 않았고, 가능하면 수동으로 설치하시기를 권장합니다.
Smithery를 통해 Claude Desktop에 Obsidian을 자동으로 설치하는 방법:
개발
그런 다음 Claude Desktop 구성에 다음을 추가합니다.
사용 가능한 도구
read-note- 노트의 내용을 읽습니다create-note- 새 노트 만들기edit-note- 기존 노트 편집delete-note- 메모 삭제move-note- 메모를 다른 위치로 이동합니다.create-directory- 새 디렉토리를 만듭니다search-vault- 보관소에서 노트 검색add-tags- 메모에 태그 추가remove-tags- 노트에서 태그 제거rename-tag- 모든 노트에서 태그 이름 변경manage-tags- 태그 나열 및 정리list-available-vaults- 사용 가능한 모든 볼트 나열(다중 볼트 설정에 도움이 됨)
선적 서류 비치
추가 문서는 docs 디렉토리에서 찾을 수 있습니다.
creating-tools.md- 새 도구 만들기 가이드tool-examples.md- 사용 가능한 도구 사용 예
보안
이 서버는 Obsidian 볼트 디렉터리에 대한 액세스 권한이 필요합니다. 서버를 구성할 때 다음 사항을 확인하세요.
의도한 보관소 디렉토리에만 액세스를 제공하세요
승인하기 전에 도구 작업을 검토하세요
문제 해결
일반적인 문제:
Claude Desktop에 서버가 표시되지 않습니다.
구성 파일 구문을 확인하세요
볼트 경로가 절대 경로이고 존재하는지 확인하세요.
Claude Desktop을 다시 시작하세요
권한 오류
볼트 경로가 읽기/쓰기 가능한지 확인하세요
볼트에서 파일 권한을 확인하세요
도구 실행 실패
Claude Desktop 로그를 다음에서 확인하세요.
macOS:
~/Library/Logs/Claude/mcp*.logWindows:
%APPDATA%\Claude\logs\mcp*.log
특허
MIT