my-obsidian-mcp

Obsidian Vault를 읽고 쓸 수 있는 MCP(Model Context Protocol) 서버입니다. Cursor, Claude Desktop 등 MCP를 지원하는 AI 클라이언트에서 Obsidian 노트를 검색, 조회, 생성, 수정할 수 있습니다.

Tools

읽기

쓰기

Daily Note

Related MCP server: Obsidian MCP Server

Resources

Prompts

활용 사례 (Use Cases)

1) 주간 회고 자동 생성 + 메타데이터 정리

• 상황: 주간 Daily Note를 기반으로 회고 문서를 만들고, 태그/상태를 일관되게 정리하고 싶을 때

• 미니 플레이북:

  1. list_daily_notes(from, to)로 주간 대상 수집

  2. 핵심 노트를 get_section(path, "TIL")로 학습 내용만 추출

  3. create_note로 Weekly/YYYY-Www.md 생성

  4. update_frontmatter로 tags, status, sourceNotes 보강

2) 프로젝트 상태보드 반자동 갱신

• 상황: 프로젝트 진행상황이 여러 노트에 흩어져 있어 한 곳에서 보기 어렵고, 주기적으로 상태보드가 필요할 때

• 미니 플레이북:

  1. search_notes로 상태 관련 키워드 수집 (status, blocked, next 등)

  2. 관련 노트들을 get_note로 집계

  3. 보드 노트를 update_note로 전체 재생성 (표/섹션)

  4. 필요 시 update_frontmatter로 updatedAt, owner 반영

3) 백링크 기반 지식 그래프 정비

• 상황: 핵심 노트가 고립되어 있고, 관련 문서 연결을 강화하고 싶을 때

• 미니 플레이북:

  1. get_backlinks(target)로 연결 빈약 노트 식별

  2. search_notes로 연관 후보 문서 찾기

  3. 추천 링크 문장을 생성해서 append_to_section(path, "Related")로 섹션에 보강

4) 장애/운영 기록 포스트모템 문서화

• 상황: Daily Note와 운영 로그에 흩어진 사건 기록을 정형화된 포스트모템으로 남기고 싶을 때

• 미니 플레이북:

  1. search_notes로 사건 키워드/에러코드 검색

  2. 관련 일자 노트를 get_note로 수집

  3. 타임라인/원인/재발방지 템플릿 문서를 create_note로 생성

  4. update_frontmatter로 severity, owner, followUpDue 추가

5) 태그 기반 월간 큐레이션 노트 작성

• 상황: 월간 학습/업무 노트 중 특정 태그 주제만 뽑아 digest 형태로 공유하고 싶을 때

• 미니 플레이북:

  1. list_tags로 태그 후보 탐색

  2. search_notes("#태그")로 후보 노트 수집

  3. 요약/선정 이유를 포함한 digest를 create_note로 작성

  4. 다음 달엔 update_note로 누적판 갱신

설치

npm install

선택 사항

search_notes의 빠른 검색을 위해 ripgrep을 설치하는 것을 권장합니다.

# macOS
brew install ripgrep

실행

# 개발 (tsx)
npm run dev -- /path/to/your/ObsidianVault

# 빌드 후 실행
npm run build
npm start -- /path/to/your/ObsidianVault

MCP 클라이언트 설정

Cursor

~/.cursor/mcp.json (또는 프로젝트 .cursor/mcp.json)에 아래와 같이 추가합니다.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "tsx",
        "/absolute/path/to/my-obsidian-mcp/src/index.ts",
        "/path/to/your/ObsidianVault"
      ]
    }
  }
}

Claude Desktop

claude_desktop_config.json에 추가합니다.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "tsx",
        "/absolute/path/to/my-obsidian-mcp/src/index.ts",
        "/path/to/your/ObsidianVault"
      ]
    }
  }
}

기술 스택

• TypeScript — ES2022, NodeNext 모듈

• @modelcontextprotocol/sdk — MCP 서버 구현 (stdio transport)

• fast-glob — 파일 탐색

• gray-matter — frontmatter 파싱

• zod — 입력 스키마 검증

• vitest — 단위/통합 테스트 (npm test)