obsidian-mcp

모든 Obsidian 볼트를 AI로 쿼리 가능한 지식 그래프로 변환하는 MCP 서버입니다.

기존 24개 이상의 Obsidian MCP 서버와 다른 점:

• 그래프 우선 — [[wikilinks]]를 통한 BFS, 최단 경로, 연결 컴포넌트, 브리지 탐지

• 인프라 제로 — 데이터베이스 없음, Obsidian 실행 불필요, API 키 없음

• 볼트 무관 — 기존 볼트와 바로 호환, 필수 구조 없음

• 백링크 인식 쓰기 — move_note가 볼트 전체의 모든 참조를 자동 업데이트

• 초경량 — 런타임 의존성 4개, ~42KB 번들

빠른 시작

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Related MCP server: some-vault-some-mcp

도구 (12개)

읽기 및 탐색

그래프 탐색

쓰기 및 조작

구성

기본적으로 구성이 필요 없습니다. 볼트 루트에 선택적으로 .obsidian-mcp.json을 둘 수 있습니다:

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLI 플래그

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

작동 방식

1. 시작 시 모든 .md 파일을 스캔하고 인메모리 그래프를 구축합니다 (노트 1,000개 기준 약 1~3초)

2. 파일 감시자가 변경을 감지하고 그래프를 증분 업데이트합니다 (변경당 약 5ms)

3. Claude가 MCP 도구를 통해 그래프를 쿼리합니다 — 재스캔이 필요 없습니다

4. 쓰기 작업은 파일시스템과 그래프를 원자적으로 업데이트합니다

하드코딩된 제외 항목: .obsidian/, .trash/, node_modules/

개발

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

라이선스

MIT