MMCPMarkets
BM

bitbonsai/mcpvault

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.7천 stars 133 forks 품질 89 트렌드 45MIT
Repository Install

안전한 Obsidian 금고 접근을 위한 경량 모델 컨텍스트 프로토콜(MCP) 서버

개요

Model Context Protocol(MCP) 표준을 사용한 Obsidian 금고용 범용 AI 브리지입니다. MCP 호환 AI 어시스턴트를 지식 베이스에 연결하세요 - Claude, ChatGPT, 그리고 미래의 AI 도구와 함께 작동합니다. 이 서버는 YAML 프론트매터 손상을 방지하면서 노트에 대한 안전한 읽기/쓰기 권한을 제공합니다. Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, Ontheia 및 MCP 표준을 채택하는 미래 AI 플랫폼 등 모든 MCP 호환 AI 어시스턴트와 호환됩니다. https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c - claude_desktop_config.json에 복사하세요: - 이 내용을 ~/.config/opencode/opencode.json로 복사하세요 /path/to/your/vault를 실제 Obsidian Vault 경로로 바꿔보세요. 다른 플랫폼에 대해서는 아래의 상세 구성 가이드를 참조하세요. 4. - "내 옵시디언 금고에 파일을 목록" - "내 노트 'project-ideas.md'을 읽어라" - "오늘 날짜로 새 노트 작성"

개요(AI 번역)

호환 클라이언트가 Obsidian 볼트 내 노트를 읽고, 검색하며, 편집할 수 있도록 하는 로컬 MCP 서버입니다. MCPVault는 볼트 파일을 직접 다루며, 파일 작업을 지정된 볼트 루트로 제한하고, 변경 없는 프론트매터 필드의 서식을 유지합니다.

https://mcpvault.org

변경 기록

지원 클라이언트

구성 예시는 Claude Desktop, Claude Code, ChatGPT Desktop(Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor, Windsurf, Ontheia에 대한 사용 가능합니다. 다른 클라이언트들은 로컬 stdio MCP 서버를 지원한다면 MCPVault를 사용할 수 있습니다.

https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c

퀵 스타트

  1. 런타임 설치Node.js:

  2. 서버 테스트:

공개된 패키지를 사용할 경우:

  1. AI 클라이언트 구성 하세요:

Claude Desktop - claude_desktop_config.json로 복사하세요:

Claude 코드 - ~/.claude.json로 복사하세요:

OpenCode - [[T4]로 복사하세요.

/path/to/your/vault를 실제 흑요석 금고 경로로 바꿔보세요.

다른 플랫폼에 대해서는 아래의 상세 구성 가이드를 참조하세요.

  1. AI로 테스트해보세요:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

MCPVault

A local MCP server that lets compatible clients read, search, and edit notes in an Obsidian vault. MCPVault works directly with vault files, restricts file operations to the configured vault root, and preserves formatting for unchanged frontmatter fields.

Supported clients

Configuration examples are available for Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor, Windsurf, and Ontheia. Other clients can use MCPVault if they support local stdio MCP servers.

https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c

Quick start

  1. Install Node.js runtime:

    # Download from https://nodejs.org (v22.12.0 or later)
# or use a package manager like nvm, brew, apt, etc.

  2. Test the server:

    If using the published package:

    npx @modelcontextprotocol/inspector npx @bitbonsai/mcpvault@latest /path/to/your/vault

  3. Configure your AI client:

    Claude Desktop - Copy this to claude_desktop_config.json:

    {
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
    }
  }
}

    Claude Code - Copy this to ~/.claude.json:

    {
  "mcpServers": {
    "obsidian": {
      "command": "npx",
GitHub에서 전체 README 보기

설치

npx @bitbonsai/mcpvault@latest /path/to/your/vault
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "obsidian": { "command": "npx", "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"] } } }