kaeru MCP
MCP-сервер kaeru хранит граф памяти агентов: мысли, итоги и источники между сессиями, локально и с общим облаком команды.
- 86 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Демон хранит графы мыслей и результатов ваших сессий и держит локальный сервер на `127.0.0.1:9876`.
- Включенный облачный уровень отправляет выбранные узлы доверенной группе.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/LamantinAI/kaeru/main/contrib/install/install.sh | bashПервая команда установки из README ставит бинарный файл и службу для Linux и macOS. Для Windows скачайте архив из релизов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Демон хранит графы мыслей и результатов ваших сессий и держит локальный сервер на `127.0.0.1:9876`.
- Включенный облачный уровень отправляет выбранные узлы доверенной группе.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kaeru — движок памяти для агентов на Rust: типизированный граф, в котором агент думает, и слой воспоминаний для долгих идей и результатов. Данные лежат локально в RocksDB, и по умолчанию ничего не покидает машину. Один демон `kaeru-mcp` владеет хранилищем, а сессии Claude Code, Opencode, Cursor и других подключаются к нему по HTTP или через `kaeru-mcp --stdio` как ретранслятор. Общий API содержит 35 именованных операций (`context`, `search`, `read`, `note`, `claim`, `synthesise`, `history`, `lifecycle` и другие): 16 частых, десять локальных служебных и девять необязательных облачных. Память делится на оперативный и архивный уровни, у узлов сохраняется история записей и отзывов, а проекты разделены инициативами. Необязательный `kaeru-cloud` дает общее хранилище для команды: узел уходит туда только по явной политике и после проверки на ключи и токены. Интерфейс на `http://127.0.0.1:9876/ui/` рисует граф знаний.
Для кого. Командам и разработчикам, которые ведут несколько агентов на одних проектах и хотят, чтобы память и ход рассуждений переживали сессии.
Подходит, если
- Агент открывает проект и должен узнать, о чем думал в прошлый раз, и пройти цепочки происхождения.
- Итоги экспериментов переносят из оперативной памяти в устойчивые знания.
- Несколько агентов и людей на одном проекте делятся узлами через общее облако команды.
- Перед вопросом пользователю агент проверяет память по хуку `kaeru-first`.
Не подходит, если
- Нужен простой файл памяти без отдельного демона: kaeru держит процесс и хранилище RocksDB.
- Планируется размещать kaeru как сервис для сторонних клиентов: лицензия BSL 1.1 это запрещает.
- Устройство на Intel Mac или Linux ARM: готовых сборок нет, нужна сборка из исходников.
Пример запроса к агенту
Подключись к kaeru, посмотри контекст проекта по инициативе `billing`, найди прошлые решения по ретраям платежей и запиши итог сегодняшнего эксперимента.MCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Переменные окружения
KAERU_VAULT_PATH- Путь к хранилищу вместо каталога по умолчанию.
KAERU_MCP_UPDATE_CHECK- Значение `0` отключает ежедневную проверку обновлений.
Ограничения
Лицензия Business Source License 1.1: код открыт, запускать и встраивать его в свои продукты можно, а отдавать сам kaeru третьим лицам как управляемый сервис нельзя; версия переходит на Apache 2.0 через четыре года. Установщик `curl | bash` скачивает релиз, ставит `kaeru-mcp` в `~/.local/bin` и создает пользовательскую службу. Демон раз в день проверяет релизы и отправляет версию, платформу и канал установки без содержимого хранилища, а `KAERU_MCP_UPDATE_CHECK=0` отключает проверку. Облачный уровень пока рассчитан на доверенную группу без изоляции пользователей.
Как отключить. Остановите службу (`systemctl --user stop kaeru-mcp` на Linux или `launchctl` на macOS), удалите подключение `claude mcp remove kaeru` и бинарный файл из `~/.local/bin`. Хранилище `KAERU_VAULT_PATH` удаляйте отдельно, если оно больше не нужно.
Частые вопросы
Как подключить kaeru к Claude Code?
Выполните `claude mcp add --transport http kaeru http://127.0.0.1:9876/mcp` при запущенном демоне. Для клиентов со stdio есть `kaeru-mcp --stdio`.
Почему один демон на хранилище?
RocksDB допускает одного пишущего, поэтому демон владеет хранилищем, а все сессии агентов подключаются к нему и не открывают вторую копию.
Уходит ли память в облако сама?
Нет. Политика инициативы по умолчанию `private`, и узел уходит в облако только после явной метки и проверки на ключи, токены и приватные ключи.
Какие агенты поддержаны?
Claude Code, Opencode, Cursor и любой клиент MCP. Для Opencode есть `contrib/opencode/install-opencode.sh`, для остальных правила из `skills/kaeru-skill/SKILL.md`.
Как отключить проверку обновлений?
Задайте переменную `KAERU_MCP_UPDATE_CHECK=0`. Демон перестанет отправлять версию и платформу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер долговременной памяти для агентов: один бинарник на Rust, который работает офлайн и не вызывает языковую модель
Общая память для группы ИИ-агентов с областями доступа, аудитом и графом знаний: MCP-сервер, Docker и облако
Локальная память для агентов в одном бинарнике на Rust: запоминает, ищет по смыслу и по слову, работает без сети и ключей
Локальный MCP-сервер с пятью командами хранит решения проекта между сессиями: запись, поиск, замена и проверка диффа до коммита.
Локальная память для агентов: решения из чатов в браузере попадают в Claude Code, Cursor и Windsurf через MCP
MCP-сервер и API общей памяти для нескольких агентов: факты, решения и события хранятся в одной базе с поиском по смыслу.
Коротко о README
README рассказывает об устройстве двух уровней памяти, перечисляет возможности и операции API, дает установку, подключение агентов, описание локального и облачного режимов, визуализатор и лицензию.