Nautilus Compass MCP
MCP-сервер долговременной памяти для кодовых агентов: поиск по прошлым сессиям на локальной модели BGE-m3 и проверка отхода от прежних правил
- 1 254 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Установка плагина прописывает хуки на каждый промпт, вызов инструмента и конец сессии в `~/.claude/settings.json` и подставляет результат в системный промпт
- Хранит и индексирует тексты прошлых сессий, в которых могут быть секреты и код; облачный шлюз принимает такие данные по HTTPS с токеном
- Запускает постоянный локальный демон и пишет файлы в `~/.claude`; токены с областью чтения по всем проектам выдаются отдельным флагом
Установка
- Работает в
Ручная установка
pip install nautilus-compassНужен Python 3.10 или новее. Приносит команды nautilus-compass, compass-mcp, compass-a2a и другие.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Установка плагина прописывает хуки на каждый промпт, вызов инструмента и конец сессии в `~/.claude/settings.json` и подставляет результат в системный промпт
- Хранит и индексирует тексты прошлых сессий, в которых могут быть секреты и код; облачный шлюз принимает такие данные по HTTPS с токеном
- Запускает постоянный локальный демон и пишет файлы в `~/.claude`; токены с областью чтения по всем проектам выдаются отдельным флагом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Nautilus Compass хранит память кодового агента между сессиями и отдает ее через MCP. Пакет `nautilus-compass` ставится из PyPI командой `pip install nautilus-compass` и приносит консольные команды `nautilus-compass`, `compass-mcp`, `compass-a2a`, `compass-drift-history`, `compass-session-search` и `compass-session-writer`. Для Claude Code есть вариант с плагином: репозиторий клонируется в `~/.claude/plugins/nautilus-compass`, скрипт `install.sh` ставит плагин, а `daemon_start.sh` запускает локальный демон с моделью эмбеддингов BGE-m3. Установщик прописывает в `~/.claude/settings.json` три хука. `UserPromptSubmit` перед каждым промптом достает из памяти подходящее прошлое и проверяет отход от правил, `PostToolUse` пишет заметки по ходу сессии, `Stop` в конце сохраняет сводку в `~/.claude/.cache/compass-last-session.txt`. Результаты подставляются в системный промпт агента. Отход оценивается так: промпт сравнивается с набором якорей, описывающих реальные ошибки, и предупреждение приходит до действия агента. Слэш-команды плагина: `/compass-verify`, `/compass-drift`, `/compass-recall`, `/compass-search` и `/compass-status`. Сервер дает 17 инструментов. Основные семь: `ingest_obs` записывает наблюдение, `recall` ищет по памяти смыслом и ключевыми словами, `session_search` ищет по журналам сессий, `profile` собирает профиль работы, `drift_check` оценивает отход, `drift_history` показывает его динамику, `feedback_log` фиксирует положительный или отрицательный сигнал. Для других клиентов (Claude Desktop, Cursor, Cline, Continue.dev, Zed) скрипт `install_to_agent.py` находит их и правит конфигурацию MCP. Есть и облачный шлюз по HTTPS с токенами и изоляцией памяти по пользователям.
Для кого. Для разработчиков, которые много работают с Claude Code или Cursor и хотят, чтобы агент помнил решения прошлых сессий и предупреждал, когда повторяет старую ошибку.
Подходит, если
- Агент забывает решения и договоренности между сессиями, и вы каждый раз пересказываете контекст проекта
- Нужен поиск по архиву прошлых сессий: что обсуждали, какие ошибки исправляли, `/compass-search` или инструмент `session_search`
- Хочется получать предупреждение до действия, если новый промпт похож на сценарии прежних сбоев: за это отвечает `drift_check`
- Память должна работать локально, на встроенных эмбеддингах BGE-m3, без отправки текстов во внешний сервис
- Несколько агентов или диалогов работают над общими файлами, и нужен учет их договоренностей и закрытия задач
Не подходит, если
- Нужна память в виде читаемых Markdown-файлов с графом связей: для этого в каталоге есть Basic Memory
- Вы не готовы к хукам в `~/.claude/settings.json`: установка плагина их прописывает, а MCP-вариант через `compass-mcp` обходится без них
- На машине нет Python 3.10 или новее либо места под модель эмбеддингов и демон
- Нужна память, которая вообще не хранит тексты прошлых сессий на диске: сервер построен на хранении и поиске по ним
Пример запроса к агенту
Подключи Nautilus Compass к Claude Code и найди в памяти, как мы в прошлый раз решили вопрос с миграцией базыMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
- Лицензия — MIT с дополнительными условиями: названия и логотип проекта нельзя использовать как торговые марки, а предлагать программу третьим лицам как хостинг-сервис без отдельной коммерческой лицензии нельзя, когда у сервиса больше 100 платящих пользователей в месяц. Самостоятельный запуск, личное и внутреннее использование разрешены. GitHub показывает лицензию как нестандартную.
- Демон с моделью BGE-m3 запускается вручную после каждой загрузки системы. Первый вызов после простоя может занять до 90 секунд из-за загрузки модели, клиент повторяет его один раз с увеличенным временем ожидания.
- Переменная `COMPASS_USE_INOTIFY=0` без сообщения отключает обнаружение новых файлов, поэтому поиск не увидит свежие записи. При таком значении демон пишет предупреждение в журнал.
- Задержка `recall` на локальном демоне около 200 мс, через облачный HTTPS автор измерил 0,9–1,7 секунды на вызов.
- Облачный шлюз находится в открытой бете и требует регистрации и токена. Доступность шлюза и загрузки модели из вашей сети проверяйте заранее.
- Репозиторий содержит много внутренних документов проекта, а не только код плагина, поэтому нужные файлы ищите через `docs/AGENT_ONBOARDING.md` и `docs/mcp-usage.md`.
Как отключить. Для режима MCP уберите запись сервера из настроек клиента и выполните `pip uninstall nautilus-compass`. Для плагина удалите три хука Compass из `~/.claude/settings.json` и папку `~/.claude/plugins/nautilus-compass`, затем остановите демон.
Частые вопросы
Как сделать, чтобы Claude Code помнил решения прошлых сессий?
Поставьте плагин Nautilus Compass: клонируйте репозиторий в `~/.claude/plugins/nautilus-compass`, запустите `install.sh` и `daemon_start.sh`. Хук `UserPromptSubmit` будет подставлять в промпт релевантное прошлое из памяти, а `Stop` в конце сессии сохранит сводку.
Какие хуки Compass прописывает в настройки Claude Code?
Три: `UserPromptSubmit` для поиска по памяти и проверки отхода, `PostToolUse` для записи заметок по ходу сессии и `Stop` для итоговой сводки. Все они записываются в `~/.claude/settings.json`.
Что делает drift_check?
Инструмент сравнивает промпт с набором якорей, описывающих реальные прежние сбои, и возвращает оценку отхода. Если якорей нет рядом с плагином, ответ содержит `drift.anchors_error` и `should_alert: true`, а не молчаливое «отхода нет».
Как подключить Compass к Cursor или Cline?
Запустите `python ~/.claude/plugins/nautilus-compass/scripts/install_to_agent.py`. Скрипт находит Claude Desktop, Cursor, Cline, Continue.dev и Zed и дополняет их конфигурацию MCP. Готовые конфигурации по агентам лежат в `docs/AGENT_ONBOARDING.md`.
Можно ли пользоваться Compass без облака?
Да, режим работы по умолчанию локальный: эмбеддинги BGE-m3 считает демон на вашей машине. Облачный шлюз `compass.nautilus.social` с токеном пользователя необязателен и подключается отдельно.
Как ограничить доступ токена к проектам?
Токены выдаются с областями: `ops/compass_token_admin.py grant <агент> --scopes read:<проект>,write:<проект>`. Чтение по всем проектам требует явного флага `--yes-i-want-star`, а скрипт быстрого старта по умолчанию выпускает токены только на чтение текущего проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПамять для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
Локальная память для агентов: хранит переписку и файлы проекта дословно и находит нужное семантическим поиском через MCP
Локальная память для Claude Code, Codex и Cursor Agent: учится на вашей активности на Mac и отдает агентам контекст со ссылками на источники по MCP
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Engram от Gentleman Programming
Engram (Gentleman Programming)
Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Nautilus Compass (эта запись) | нет | не нужна | 1 254 | |
| Mem0 | нет | 67 649 | слой памяти с плагинами для Claude Code, Codex, Cursor и OpenCode, CLI и SDK | |
| MegaMemory | нет | не нужна | 725 | MCP-сервер памяти в виде графа понятий, архитектуры и решений проекта |
| Basic Memory | нет | не нужна | 4 323 | память в локальных Markdown-файлах с графом связей, семантическим поиском и доступом через MCP |
Коротко о README
Главная страница начинается с блока о новом направлении проекта, независимой проверке и оценке решений в платформе Nautilus, затем описывает три опоры: долговременную память, обнаружение отхода и контракты между агентами. Дальше идут установка из PyPI и в виде плагина, подключение других клиентов MCP и облачный шлюз, таблица из семи основных инструментов и область токенов. Заканчивается страница сравнением с другими слоями памяти, описанием переменных окружения, ссылками на документы и сводкой измерений, которые автор приводит как собственные воспроизведения.