PMB MCP
Локальная память для Claude Code, Cursor и Codex в одном файле SQLite: прошлые решения и уроки попадают в контекст агента сами
- 287 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Хуки подмешивают содержимое локальной памяти в контекст перед каждым ответом модели
- Хранит в одном файле SQLite решения, факты о проекте и его структуру, доступные через MCP любому подключенному агенту
Установка
- Работает в
Ручная установка
pip install pmb-aiКоманда CLI после установки — pmb (алиас pmb-ai). Через npm доступен npx pmb-ai setup, который сначала ставит пакет Python.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки подмешивают содержимое локальной памяти в контекст перед каждым ответом модели
- Хранит в одном файле SQLite решения, факты о проекте и его структуру, доступные через MCP любому подключенному агенту
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PMB — локальная память для ИИ-агентов. Она хранит решения, уроки, факты о проекте и его структуре в одном файле SQLite на диске. После `pip install pmb-ai` команда `pmb setup` сама находит установленного агента и прописывает MCP-подключение. В Claude Code и Codex PMB работает через хуки: перед ответом модели хук сам вызывает prepare() и подкладывает в контекст подходящие события, уроки, решения и открытые цели проекта. Агенту не нужно помнить о вызове инструмента памяти. В Cursor, Windsurf, Zed, VS Code и других клиентах PMB подключается как обычный MCP-сервер командой `pmb connect`. Поиск по памяти многоязычный: модель эмбеддингов покрывает более 50 языков, и запрос на русском находит факт, записанный на английском. Команда `pmb dashboard` поднимает локальную веб-панель на 127.0.0.1:8765 с графом связей между сущностями и хронологической лентой записей. Команда `pmb export` выгружает всю память в Markdown или JSON.
Для кого. Для разработчиков, которые много сессий подряд ведут один проект в Claude Code, Cursor или Codex.
Подходит, если
- Агент должен сам вспоминать решения и уроки прошлых сессий до начала ответа
- Проект ведется в нескольких агентах, например в Claude Code и Cursor, и память должна быть общей
- Нужен поиск по памяти из терминала без обращения к агенту, например `pmb recall "решение по авторизации"`
- Важно видеть, какие уроки и факты реально повлияли на ответы агента
- Запросы к памяти идут на разных языках, и русский вопрос должен находить факт, записанный на английском
Не подходит, если
- Нужна командная память, общая для нескольких разработчиков в реальном времени: PMB хранит один локальный файл SQLite на машине пользователя
- Агент не поддерживает MCP: подключить PMB к нему не получится
- Нужно хранить в памяти агента секреты и учетные данные: PMB рассчитан на решения, уроки и факты о проекте
Пример запроса к агенту
Вспомни, какое решение мы принимали по политике повторных попыток на прошлой неделе, и покажи связанные урокиMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Хуки, которые подкладывают память до ответа модели, работают только в Claude Code и Codex. В Cursor, Windsurf и других клиентах агент сам решает, когда вызвать инструмент памяти.
- Семантический поиск работает только с локальной моделью эмбеддингов, которую нужно скачать на машину.
- Пакет ставится из PyPI. Вариант через npm (`npx pmb-ai setup`) все равно сначала ставит пакет Python.
- Веб-панель не запускается вместе с MCP-сервером, ее поднимают отдельной командой.
Как отключить. Удалите MCP-запись PMB из конфигурации агента (команда `pmb setup` показывает, куда она добавлена) и удалите пакет командой `pip uninstall pmb-ai`. Локальный файл памяти можно стереть вручную из рабочей папки PMB.
Частые вопросы
Как PMB подключается к Claude Code и Cursor одновременно?
Команда `pmb setup` прописывает MCP-подключение для каждого найденного агента по отдельности, и все они работают с одним файлом памяти.
Нужен ли API-ключ или подписка для PMB?
Нет. PMB работает локально: SQLite хранит память, рядом лежат поисковые индексы, которые можно перестроить, а чтение не вызывает LLM.
Как посмотреть, что PMB запомнил?
Команда `pmb stats` показывает сводку того, что лежит в памяти. Для поиска из терминала есть `pmb recall "запрос"`.
Почему первый вызов памяти в PMB может быть медленным?
Если модель эмбеддингов не прогрета заранее, первый вызов памяти ждет ее загрузки. Команда `pmb warmup` прогревает модель сразу после установки, и дальше поиск по памяти идет быстро.
Можно ли вручную отредактировать или удалить запись из памяти PMB?
Да. Вся память лежит в одном файле SQLite на вашем диске, и у проекта есть инструкция по удалению отдельных записей.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыloci собирает заметки и память агентов в одну базу знаний с гибридным поиском и ответами со ссылкой на раздел файла.
Локальная вики-память из того, что вы читаете: общий каталог знаний для агентов через MCP-мост и команду my-curator.
ChatCrystal — заметки из диалогов с агентами
ChatCrystal
Локальная база знаний: импорт диалогов Claude Code, Cursor, Codex и других агентов, заметки, поиск по смыслу и память по MCP
Скилл Claude Code собирает контекст продукта в Markdown и связывает решения с интервью, документами и гипотезами
compound-memory каждую ночь превращает ваши беседы с ИИ в память о вас и подмешивает ее в новые сессии Claude Code и Codex
Трекер проекта на SQLite в одном бинарнике: CLI, веб-интерфейс и скилл /pad, через который агент ведет задачи, планы и идеи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| PMB (эта карточка) | нет | не нужна | 287 | |
| MCP Memory Service | нет | не нужна | 2 117 | самостоятельно размещаемый сервис с графом знаний и семантическим поиском, без автоматических хуков в Claude Code и Codex |
| Basic Memory | нет | не нужна | 4 566 | память в локальных Markdown-файлах с графом связей, без модели эмбеддингов для более 50 языков |
Коротко о README
Автор начинает с проблемы забывчивости агентов и быстрого старта из семи шагов, от установки до проверки командой `pmb doctor`. Демо-сценарий сравнивает работу агента с памятью и без нее.