Skip to main content
Glama
Obsidian MCP Local

Obsidian MCP Local

Obsidian MCP Local

Obsidian 볼트를 VS Code + GitHub Copilot에 노출하기 위한 Node.js + TypeScript 기반의 MCP 로컬 서버입니다.

이 프로젝트는 볼트 내의 Markdown 노트를 읽고 쓰는 데 중점을 두고 stdio를 통한 로컬 사용을 위해 설계되었습니다.

설치

npm install -g obsidian-mcp-local

Related MCP server: Obsidian MCP Server

기능

사용 가능한 도구

  • search_notes(query)

    • 노트의 경로, 프런트매터 및 콘텐츠 내에서 텍스트 검색

    • 짧은 발췌문과 함께 순위가 매겨진 결과 반환

  • get_note(path)

    • 볼트에서 노트 열기

    • path, frontmatter, content 반환

  • create_note(path, content, overwrite?)

    • 새 노트 생성

    • 선택적으로 기존 노트 덮어쓰기 가능

  • append_to_note(path, content)

    • 기존 노트 끝에 콘텐츠 추가

  • find_by_tag(tag)

    • 태그별로 노트 찾기

    • 프런트매터의 tags 및 콘텐츠 내 인라인 태그 지원

구현된 규칙

  • 설정된 볼트 내부의 파일에만 액세스

  • 다음 디렉토리 무시:

    • .obsidian

    • .git

    • node_modules

  • .md 파일만 처리

  • 기본 디렉토리 외부로의 액세스를 방지하기 위해 경로 정규화

프로젝트 구조

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

사전 요구 사항

  • Node.js 20+

  • npm

  • GitHub Copilot이 포함된 VS Code

  • 로컬 Obsidian 볼트

설치

프로젝트 디렉토리에서:

npm install
npm run build

개발용:

npm run dev

컴파일된 버전 실행:

npm start

VS Code에서 사용하는 방법

1. 프로젝트 컴파일

npm install
npm run build

2. VS Code MCP 파일 조정

.vscode/mcp.example.json의 내용을 Copilot을 사용할 워크스페이스의 .vscode/mcp.json으로 복사합니다.

예시: 로컬에서 사용하는 경우:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

npx를 사용하는 경우 (로컬 빌드 불필요):

{
  "servers": {
    "obsidian-local-vault": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-local"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. 경로 업데이트

다음 경로를:

  • C:/caminho/para/obsidian-mcp-local/dist/index.js

  • D:/Obsidian/Vault

사용자의 실제 머신 경로로 교체하세요.

4. VS Code 재시작/새로고침

이후 Copilot이 MCP 서버를 감지해야 합니다.

Copilot Chat 사용 예시

  • “내 볼트에서 .NET에 관한 노트를 찾아줘”

  • “knowledge/backend/dotnet.md 노트를 열어줘”

  • “inbox/ideias-mcp.md에 우리가 논의한 내용을 요약해서 노트를 만들어줘”

  • “daily/2026-04-06.md 노트 끝에 - testar MCP local 텍스트를 추가해줘”

  • “#arquitetura 태그가 있는 노트를 찾아줘”

향후 개선 가능 사항

  • append_under_heading

  • [[wikilinks]] 파싱

  • get_backlinks(note)

  • 빠른 검색을 위한 SQLite 인덱스

  • 쓰기용 폴더 화이트리스트 (inbox/, daily/, scratch/)

  • 특정 폴더에 대한 쓰기 차단 설정

중요 참고 사항

  • 이 프로젝트는 Obsidian이 열려 있을 필요가 없습니다.

  • 볼트 파일에 직접 작동합니다.

  • Obsidian과 VS Code 모두에서 쓰기를 활성화하는 경우, 동시성 제어는 사용자의 책임입니다.

  • 현재 프로젝트는 볼트가 로컬 Markdown 폴더임을 가정합니다.

메인 파일

구현 위치:

  • src/index.ts

라이선스

개인 사용 / 커스터마이징을 위한 초기 기반.

Available Tools

5 tools
append_to_noteD

Inputs: path (required), content (required).

create_noteD

Inputs: path (required), content (required), overwrite.

find_by_tagD

Inputs: tag (required).

get_noteD

Inputs: path (required).

search_notesD

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.

    Tool Count5/5

    Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.

    Completeness3/5

    The set includes create, read, update (via append), and search operations but lacks a delete operation, which is a notable gap for a complete CRUD surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.
      3,713 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with local Obsidian vaults through direct filesystem access for reading, creating, and managing notes. It features high-performance SQLite indexing for fast searches, regex support, and tools for organizing tags and links without requiring additional plugins.
      27
      1
      MIT