흑요석 MCP 서버

AI 어시스턴트가 Obsidian 볼트와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버로, 노트와 태그를 읽고, 만들고, 편집하고, 관리할 수 있는 도구를 제공합니다.

경고!!!

이 MCP는 읽기 및 쓰기 권한이 있습니다(허용하는 경우). obsidian-mcp를 사용하여 노트를 관리하기 전에 Obsidian 볼트를 백업해 주세요. git 사용을 권장하지만, 어떤 백업 방법이든 괜찮습니다. 이러한 도구들은 테스트되었지만 아직 완전히 테스트되지 않았으며, 이 MCP는 현재 개발 중입니다.

Related MCP server: Vault Cortex

특징

• 보관소에서 메모를 읽고 검색하세요

• 새로운 메모와 디렉토리 만들기

• 기존 노트 편집

• 메모 이동 및 삭제

• 태그 관리(추가, 제거, 이름 변경)

• 보관함 내용 검색

요구 사항

• Node.js 20 이상(더 낮은 버전에서도 작동할 수 있지만 테스트하지 않았습니다)

• 흑요석 금고

설치하다

수동 설치

Claude Desktop 구성에 다음을 추가합니다.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

지엑스피1

/path/to/your/vault Obsidian 볼트의 절대 경로로 바꾸세요. 예:

MacOS/리눅스:

"/Users/username/Documents/MyVault"

윈도우:

"C:\\Users\\username\\Documents\\MyVault"

구성을 저장한 후 Claude for Desktop을 다시 시작하세요. 서버가 연결되었음을 나타내는 망치 아이콘이 나타납니다.

연결 문제가 있는 경우 다음 위치에서 로그를 확인하세요.

• MacOS: ~/Library/Logs/Claude/mcp*.log

• Windows: %APPDATA%\Claude\logs\mcp*.log

Smithery를 통해 설치

경고: 저는 Smithery와 아무런 관련이 없습니다. 직접 사용해 보지도 않았고, 가능하면 수동으로 설치하시기를 권장합니다.

Smithery를 통해 Claude Desktop에 Obsidian을 자동으로 설치하는 방법:

npx -y @smithery/cli install obsidian-mcp --client claude

개발

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

그런 다음 Claude Desktop 구성에 다음을 추가합니다.

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

사용 가능한 도구

• 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 볼트 디렉터리에 대한 액세스 권한이 필요합니다. 서버를 구성할 때 다음 사항을 확인하세요.

• 의도한 보관소 디렉토리에만 액세스를 제공하세요

• 승인하기 전에 도구 작업을 검토하세요

문제 해결

일반적인 문제:

1. Claude Desktop에 서버가 표시되지 않습니다.

   • 구성 파일 구문을 확인하세요

   • 볼트 경로가 절대 경로이고 존재하는지 확인하세요.

   • Claude Desktop을 다시 시작하세요

2. 권한 오류

   • 볼트 경로가 읽기/쓰기 가능한지 확인하세요

   • 볼트에서 파일 권한을 확인하세요

3. 도구 실행 실패

   • Claude Desktop 로그를 다음에서 확인하세요.

     • macOS: ~/Library/Logs/Claude/mcp*.log

     • Windows: %APPDATA%\Claude\logs\mcp*.log

특허

MIT