Obsidian Gate

모든 AI 에이전트에 Obsidian 볼트를 여는 MCP 서버.

npx obsidian-gate init     # point at your vault
npx obsidian-gate          # dashboard on :3100

Obsidian 볼트는 당신의 제2의 뇌입니다. AI 에이전트도 그것을 사용할 수 있어야 합니다.

Claude Code, Codex, Cursor — 한 줄의 설정으로 볼트가 에이전트 접근 가능한 작업 공간이 됩니다. 모든 노트, 모든 링크, 모든 태그. 전부 로컬, 전부 당신의 것, 클라우드 없음.

사용해 보기

# One command to set up
npx obsidian-gate init

# Start the dashboard
npx obsidian-gate
# → http://localhost:3100/dashboard

그게 전부입니다. 이제 에이전트가 볼트를 읽고, 검색하고, 쓸 수 있습니다.

Related MCP server: obsidian-mcp

빠른 시작

1. 볼트 지정

npx obsidian-gate init

볼트 경로를 입력하면 API 키가 발급됩니다.

2. 에이전트 연결

Claude Code — MCP 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-gate", "--mcp"]
    }
  }
}

모든 MCP 클라이언트 — HTTP로:

{
  "mcpServers": {
    "obsidian": {
      "type": "http",
      "url": "http://localhost:3100/mcp",
      "headers": { "Authorization": "Bearer sk-your-key" }
    }
  }
}

3. 에이전트에게 요청

다음을 시도해 보세요:

도구 — 9가지 작업

노트는 MCP 리소스로도 노출됩니다: obsidian://{vault}/{path}

CLI

요금제

유료 플랜은 14일 무료 체험. 부담 없이 언제든 취소 가능.

아키텍처

┌────────────┐     ┌──────────────────────┐     ┌──────────────┐
│ AI Agent   │────▶│   obsidian-gate      │────▶│  Obsidian    │
│ (Claude,   │◀────│   (MCP Server)       │◀────│  Vault       │
│  Codex,    │     │                      │     │  (files)     │
│  Cursor)   │     │  stdio ─ dashboard   │     └──────────────┘
└────────────┘     └──────────────────────┘

• 전부 로컬. 모든 데이터는 당신의 머신에 저장됩니다. 클라우드 없음, 서버 없음, 동기화 없음.

• 설정 파일: ~/.obsidian-gate/config.json (모드 0600)

• API 키는 로컬 비밀번호입니다. 당신이 스택을 소유합니다.

• 활동 로그는 모든 에이전트 작업을 JSONL로 기록합니다.

Gate가 아닌 것

• ❌ Obsidian 플러그인이 아님 (하지만 커뮤니티 플러그인은 계획 중)

• ❌ 동기화 엔진이 아님 (볼트 디렉터리를 직접 읽고 씀)

• ❌ 노트 편집기가 아님 (그건 Obsidian이 더 잘함)

• ❌ 클라우드 서비스가 아님 (전적으로 당신의 머신에서 실행)

볼트를 위한 MCP 서버 하나, 잘 만든 것 하나.

로드맵

• 9가지 도구를 갖춘 MCP 서버

• 로컬 대시보드 + 활동 로그

• API 키 인증 + 권한

• Stripe 라이선스 (무료 + 유료 등급)

• Obsidian 커뮤니티 플러그인 (원클릭 설치)

• LLM 프론트매터를 통한 에이전트 기록

• 볼트 콘텐츠 자동 태깅

• 일일 다이제스트: 볼트의 변경 사항

개발

git clone https://github.com/rileygramlich/obsidian-gate.git
cd obsidian-gate
npm install
npm run build     # compile TypeScript → dist/
npm run dev       # hot-reload with tsx

Riley G. 제작 — Marc Lou 플레이북에서 영감: 빠르게 출시, 무료 등급, 광고 지출 0, 공개적으로 구축.

MIT — 그 위에 구축하고, 출시하고, 판매하세요.