Hive Vault

Hive Vault

mlorentedevMIT
4 звёзд1 форков
Hive Vault — MCP-сервер, который соединяет AI-ассистента с вашим Obsidian-хранилищем. Вместо полной загрузки всех заметок в контекст он извлекает только то, что нужно в данный момент. Это резко снижает количество токенов и позволяет ассистенту помнить информацию между сессиями. Сервер ориентирован на разработчиков и технических специалистов, которые ведут базу знаний в Obsidian и хотят использовать AI-ассистента для работы с ней. В поставке — 17 инструментов, 5 ресурсов и 4 промпта.
Ai-mlDevelopmentObsidian
Открыть на GitHub

Установка

uvx hive-vault

Характеристики

Общее

  • СтатусСообщество
  • Разработчикmlorentedev
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Чтение любой заметки из Obsidian по её пути или названию.
  • Поиск по содержимому и заголовкам с учётом структуры папок.
  • Создание новых файлов Markdown в хранилище.
  • Редактирование существующих заметок — добавление, изменение или удаление текста.
  • Маршрутизация запросов по разделам хранилища (00_meta, 10_projects, 50_work, 80_agents).
  • Сокращение потребления токенов до 6% по сравнению с загрузкой всего хранилища.
  • Сохранение знаний между сессиями: всё, что записано в Obsidian, остаётся доступным ассистенту.
  • Работа без настроенного хранилища — инструменты вернут понятную ошибку до установки VAULT_PATH.
  • Поддержка нескольких клиентов: Claude Desktop, Gemini CLI, Copilot, Cursor, Windsurf.
  • Измерения производительности на реальном хранилище с 19 проектами и более 200 файлами.

Как подключить

  1. Установите сервер одной командой: 
    uvx hive-vault
    Для Claude Desktop можно сразу задать путь к хранилищу: 
    claude mcp add -s user hive -e VAULT_PATH=$HOME/path/to/vault -- uvx --upgrade hive-vault
  2. Добавьте сервер в конфигурацию. Для Claude Desktop отредактируйте файл claude_desktop_config.json: 
    {
  "mcpServers": {
    "hive": {
      "command": "uvx",
      "args": ["--upgrade", "hive-vault"],
      "env": {
        "VAULT_PATH": "/путь/к/вашему/хранилищу"
      }
    }
  }
}
  3. Перезапустите клиент (Claude Desktop, Gemini CLI или другой MCP-клиент). Теперь ассистент может обращаться к вашему Obsidian-хранилищу.

По умолчанию сервер ищет хранилище в ~/Projects/knowledge. Если его нет, инструменты вернут ошибку с подсказкой. Укажите правильный путь через переменную VAULT_PATH.

Примеры запросов

  • «Покажи содержимое заметки "Архитектура системы" из раздела 10_projects».
  • «Найди все заметки, в которых упоминается "MCP" и "Obsidian"».
  • «Создай новый файл в корне хранилища с именем "daily/2025-03-20.md" и запиши туда план на день».
  • «Обнови заметку "README.md": добавь в начало строку с датой последнего изменения».

Технические детали

  • Язык: Python 3.12+
  • Транспорт: stdio
  • Лицензия: MIT
  • Количество инструментов MCP: 17, ресурсов: 5, промптов: 4
  • Совместимые клиенты: Claude Desktop, Gemini CLI, GitHub Copilot, Cursor, Windsurf и любые другие MCP-клиенты
  • Требования: наличие Obsidian-хранилища (директория с Markdown-файлами). Структура папок не обязательна, но рекомендуется разделы 00_meta, 10_projects, 50_work, 80_agents.

Поделиться