local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags within Obsidian.

흑요석 MCP 서버

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

경고!!!

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

특징

보관소에서 메모를 읽고 검색하세요
새로운 메모와 디렉토리 만들기
기존 노트 편집
메모 이동 및 삭제
태그 관리(추가, 제거, 이름 변경)
보관함 내용 검색

요구 사항

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

의도한 보관소 디렉토리에만 액세스를 제공하세요
승인하기 전에 도구 작업을 검토하세요

문제 해결

일반적인 문제:

Claude Desktop에 서버가 표시되지 않습니다.
- 구성 파일 구문을 확인하세요
- 볼트 경로가 절대 경로이고 존재하는지 확인하세요.
- Claude Desktop을 다시 시작하세요
권한 오류
- 볼트 경로가 읽기/쓰기 가능한지 확인하세요
- 볼트에서 파일 권한을 확인하세요
도구 실행 실패
- Claude Desktop 로그를 다음에서 확인하세요.
  - macOS: ~/Library/Logs/Claude/mcp*.log
  - Windows: %APPDATA%\Claude\logs\mcp*.log

특허

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

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