MCPVault

Установка

npx skillfoxx add mcp/mcpvault

claude mcp add --transport stdio obsidian -- npx @bitbonsai/mcpvault@latest /path/to/your/vault

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

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

code --add-mcp '{"name":"obsidian","type":"stdio","command":"npx","args":["@bitbonsai/mcpvault@latest","/path/to/your/vault"]}'

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

codex mcp add obsidian -- npx @bitbonsai/mcpvault@latest /path/to/your/vault

[mcp_servers.obsidian]
command = "npx"
args = ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]

gemini mcp add -s user obsidian npx @bitbonsai/mcpvault@latest /path/to/your/vault

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

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

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

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

{
  "mcp": {
    "obsidian": {
      "type": "local",
      "command": [
        "npx",
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

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

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

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCPVault запускается как локальный процесс по stdio и дает MCP-клиенту доступ к папке заметок Obsidian. Он предоставляет восемнадцать инструментов: чтение, запись, правку, удаление и перемещение заметок и файлов, частичное чтение и структуру заметки, работу с каталогами и пакетное чтение, поиск с многословным совпадением и переранжированием BM25, работу с frontmatter и тегами и разрешение wiki-ссылок. Правки frontmatter учитывают формат и сохраняют оформление неизменных полей YAML. Операции ограничены корнем хранилища: сервер блокирует выход за пределы папки, символьные ссылки, dotfiles и служебные каталоги вроде .obsidian, .git и node_modules. Удаление и перемещение требуют совпадающего пути подтверждения. Obsidian при этом запускать не нужно, плагин к нему не требуется.

Для кого. Для тех, кто ведет базу знаний в Obsidian и хочет читать и править заметки через ИИ-ассистента с ограничением доступа.

Пример запроса к агенту

Найди в моем хранилище заметки про планы на квартал и собери из них короткое резюме

Ограничения

Сервер работает с локальными файлами и требует Node.js 20 или новее. Доступ жестко ограничен указанным корнем хранилища. Удаление и перемещение выполняются только при совпадающем пути подтверждения. Сетевых интеграций у самого сервера нет, поэтому доступность зависит только от клиента.

Как отключить. Удалите запись obsidian из конфигурации MCP вашего клиента и перезапустите его.

MCP

Транспорт

stdio

Авторизация

не нужна

Проверка безопасности

• Читает и изменяет файлы заметок в указанной папке
• Может удалять и перемещать заметки, хотя это требует подтверждающего пути

Коротко о README

README описывает MCPVault как локальный MCP-сервер, который дает совместимым клиентам читать, искать и править заметки в хранилище Obsidian, ограничивая операции корнем хранилища. Клиент запускает сервер как локальный процесс по stdio и передает путь к папке, одни и те же инструменты доступны всем поддерживаемым клиентам. Есть примеры конфигурации для Claude Desktop, Claude Code, ChatGPT Desktop, OpenCode, Gemini CLI, Codex, IntelliJ IDEA, Cursor, Windsurf и Ontheia. Восемнадцать инструментов покрывают операции с файлами, частичное чтение, поиск с переранжированием BM25, frontmatter, теги и wiki-ссылки, удаление и перемещение требуют подтверждающего пути. Пакет публикуется в npm, лицензия MIT.

Похожие