Obsidian Vault MCP (무료, 카드 불필요, 항상 켜져 있는 컴퓨터 불필요)

이 도구는 Claude(모바일, 데스크톱, 웹)가 Render에서 무료로 호스팅되는 작은 서버를 통해 GitHub 저장소에서 직접 읽어와 Obsidian 볼트에 읽기 접근할 수 있게 해줍니다. 볼트는 Obsidian Git 플러그인을 통해 휴대폰과 데스크톱에서 GitHub에 동기화되며, 계속 켜져 있을 필요가 없습니다.

구성 요소

• GitHub 저장소 — 볼트의 진실 공급원(무료, 비공개).

• Obsidian Git 플러그인 — 데스크톱 + 휴대폰에서 자동 커밋/푸시/풀.

• 이 MCP 서버 — GitHub API를 통해 저장소를 읽고, list_notes, read_note, search_notes를 MCP로 제공합니다. Render에 무료로 배포됩니다.

• Graphify — 선택 사항, 로컬에서 실행하고, 다른 노트처럼 출력을 저장소에 커밋합니다.

Related MCP server: Obsidian MCP Server

1. GitHub 저장소 만들기

1. github.com → 새 저장소 → 이름 예: obsidian-vault → 비공개 → 만들기.

2. 설정 → 개발자 설정 → 개인 액세스 토큰 → 세분화된 토큰:

   • 저장소 액세스: 이 저장소만.

   • 권한: 콘텐츠 → 읽기 및 쓰기 (Claude가 노트를 읽을 뿐만 아니라 만들고 편집할 수 있도록 필요).

   • 토큰을 복사하세요 — Render에 GITHUB_TOKEN으로 붙여넣습니다.

2. Obsidian Git 연결 (데스크톱 + 휴대폰)

1. Obsidian → 설정 → 커뮤니티 플러그인 → 찾아보기 → Obsidian Git 설치.

2. 볼트 폴더를 저장소의 로컬 클론으로 지정하거나(또는 그 자리에서 git init하고 GitHub 저장소를 origin으로 추가).

3. 플러그인 설정에서 간격 자동 백업(예: 10분마다)과 로드 시 자동 풀을 켜면 자동으로 커밋 + 푸시 + 풀을 수행합니다.

4. 휴대폰: Obsidian 모바일 설치, 동일한 플러그인 추가(iOS/Android에서 작동), 플러그인 인증 화면에서 GitHub에 로그인.

이제 모든 기기가 동일한 저장소에 푸시/풀을 수행합니다 — 그 저장소가 동기화 계층입니다.

3. Render에 MCP 서버 배포 (무료)

1. 이 폴더(server.js, package.json, render.yaml)를 자체 공개 또는 비공개 GitHub 저장소(볼트 저장소와 별도)에 푸시합니다.

2. render.com → 새로 만들기 → 웹 서비스 → 해당 저장소 연결.

3. render.yaml을 자동으로 감지해야 합니다. 그렇지 않은 경우: 빌드 명령 npm install, 시작 명령 npm start, 요금제 무료.

4. 환경 변수 추가:

   • GITHUB_TOKEN — 1단계의 세분화된 토큰

   • GITHUB_OWNER — GitHub 사용자 이름

   • GITHUB_REPO — 볼트 저장소 이름(예: obsidian-vault)

   • GITHUB_BRANCH — main(또는 기본 브랜치)

   • MCP_SHARED_SECRET — 임의의 문자열 생성; Render URL을 찾은 사람이 볼트를 읽지 못하도록 보호

5. 배포. https://obsidian-vault-mcp.onrender.com과 같은 URL을 받게 됩니다.

무료 요금제 참고: 약 15분 동안 유휴 상태이면 절전 모드로 전환되고 다음 요청 시 깨어나는 데 몇 초가 걸립니다 — 가끔씩 Claude 쿼리에 적합합니다.

4. Claude에 연결

Claude → 설정 → 커넥터 → 사용자 지정 커넥터 추가:

• URL: https://<your-app>.onrender.com/mcp

• 헤더: Authorization: Bearer <your MCP_SHARED_SECRET>

그런 다음 Claude에게 노트 검색, 읽기 또는 편집을 요청하면 자동으로 search_notes / read_note / list_notes / write_note / delete_note를 호출합니다. 쓰기는 저장소에 직접 커밋되므로, Obsidian Git이 동기화될 때(또는 간격 자동 풀이 켜져 있으면 즉시) 휴대폰/데스크톱에 나타납니다.

쓰기 관련 주의사항: write_note는 전체 파일을 덮어씁니다 — 기존 노트를 편집하려면 Claude가 먼저 읽은 다음 전체 업데이트된 내용을 다시 쓰도록 하세요. delete_note는 실제 영구적인 git 커밋입니다. 삭제하기 전에 Claude에게 확인을 요청하는 것이 좋습니다.

5. Graphify — 자동, 무료, 호스팅 불필요

Graphify는 노트에서 지식 그래프를 구축합니다. 의미론적 추출에는 LLM이 필요하며, 호스팅이 필요 없는 무료 옵션은 Google의 Gemini API 무료 요금제(신용카드 불필요, 만료되지 않음)입니다.

무료 Gemini 키 받기:

1. aistudio.google.com으로 이동, Google 계정으로 로그인.

2. API 키 받기 → API 키 만들기. 복사.

GitHub Actions 워크플로 추가:

1. 볼트 저장소에 .github/workflows/graphify.yml을 만들고 이 프로젝트의 vault-workflow/.github/workflows/graphify.yml 내용을 추가합니다.

2. 저장소 → 설정 → 비밀 및 변수 → Actions → 새 저장소 비밀:

   • 이름: GEMINI_API_KEY

   • 값: AI Studio의 키

3. 저장소 → 설정 → Actions → 일반 → 워크플로 권한 → 읽기 및 쓰기 권한으로 설정(워크플로가 그래프를 다시 커밋할 수 있도록).

4. 하루에 한 번 자동으로 실행되며, 볼트에 변경 사항을 푸시할 때마다 실행됩니다. 저장소의 Actions 탭에서 수동으로 트리거할 수도 있습니다.

이렇게 하면 볼트 저장소에 graphify-out/graph.json과 graphify-out/GRAPH_REPORT.md가 생성됩니다 — 서버, Space, 계속 실행할 것이 없습니다.

MCP 서버에는 이미 이를 위한 도구가 있습니다(graph_overview, graph_find_node, graph_neighbors) — read_note와 같은 방식으로 GitHub에서 직접 그래프를 읽습니다. 추가로 배포할 것은 없습니다. 업데이트된 server.js를 Render에 다시 배포하기만 하면 Claude가 다음에 연결할 때 나타납니다.

로컬 테스트 (선택 사항, 배포 전)

npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm start

그런 다음 MCP 클라이언트로 http://localhost:3000/mcp에 POST하거나, Render에 바로 배포하여 Claude를 통해 테스트하세요.