better bear

MCP-сервер и CLI для заметок Bear через CloudKit. Включает библиотеку контекста — курируемую, синхронизированную папку заметок, оптимизированную для использования LLM, вдохновленную шаблоном базы знаний LLM от Карпатого.

Полная документация: better-bear.com

Установка

Установите CLI, затем подключитесь к Claude:

curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install

Это установит бинарный файл bcli, выполнит аутентификацию в iCloud и настроит MCP-сервер как для Claude Desktop (через пакет .mcpb), так и для Claude Code.

Другие способы установки

Управление

bcli mcp status      # check what's configured
bcli mcp uninstall   # remove from Claude Desktop and Claude Code
bcli mcp reinstall   # clean uninstall + install
bcli upgrade         # upgrade bcli binary

CLI

Все команды также работают автономно из терминала:

bcli ls                          # list notes
bcli search "query"              # full-text search
bcli create "Title" -b "Body"    # create a note
bcli edit <id> --append "text"   # append to a note
bcli tags                        # list all tags
bcli attach <id> photo.jpg       # attach a file
bcli stats                       # library statistics
bcli health                      # health check

Полный справочник команд см. на better-bear.com.

Библиотека контекста

Превратите подмножество ваших заметок Bear в синхронизированную, курируемую папку контекста, по которой Claude может перемещаться, используя поиск по индексу. Пометьте заметки тегом #context в Bear, синхронизируйте, и Claude прочитает компактный индекс, чтобы найти нужные файлы — загружая только то, что ему нужно, а не всё подряд.

bcli context init                          # one-time setup
bcli context sync                          # pull qualifying notes
bcli context add <id> --subtag research    # tag a note for inclusion
bcli context status                        # health check

Или скажите Claude: "Set up a context library" («Настрой библиотеку контекста») — и он сделает всё через инструменты MCP.

Архитектура следует трехпапочному шаблону Карпатого: bear/ (синхронизируется из CloudKit), external/ (PDF, экспортированные файлы, общие документы) и inbox/ (зона для сортировки). Манифест index.md отображает всё содержимое. Полную документацию см. на better-bear.com.

Инструменты MCP

34 инструмента, охватывающих заметки, теги, задачи (TODO), вложения, поиск, метаданные (front matter), статистику, проверки работоспособности и библиотеку контекста. Полный список см. в README MCP-сервера.

Участники