Локальный MCP-сервер, позволяющий совместимым клиентам читать, искать и редактировать заметки в хранилище Obsidian. MCPVault работает напрямую с файлами хранилища, ограничивает операции с файлами только настроенным корнем хранилища и сохраняет форматирование для неизменных полей фронтматера.

https://mcpvault.org

Журнал изменений

Поддерживаемые клиенты

Примеры конфигураций доступны для Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor, Windsurf и Ontheia. Другие клиенты могут использовать MCPVault, если они поддерживают локальные stdio MCP серверы.

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

Быстрый старт

1. Установите Node.js runtime:

2. Протестируйте сервер:

Если использовать опубликованный пакет:

3. Настройте свой AI-клиент:

Claude Desktop - Скопировать это в claude_desktop_config.json:

Код Клода - Скопировать это в ~/.claude.json:

OpenCode - Скопировать это в ~/.config/opencode/opencode.json

Замените /path/to/your/vault на ваш реальный путь к хранилищу из Obsidian.

Для других платформ смотрите подробные руководства по конфигурации ниже.

4. Тестируйтесь с вашим ИИ:

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",