projectmem
projectmem — MCP-сервер сообщества (автор — riponcm). Локальная память агента для всех проектов с предупреждением о повторе неудачных исправлений. Ставится через pip. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- riponcm
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- linux, macos, windows
- Языки
- python
Уровень риска: high
Пишет в репозиторий (.projectmem/, git-хуки, наблюдение за файлами); обобщённая память по умолчанию коммитится.
Настройка клиентов
{
"code": "[mcp_servers.projectmem]\ncommand = \"/opt/anaconda3/bin/python\"\nargs = [\"-m\", \"projectmem.mcp_server\"]",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
projectmem — локальная память для ИИ-агентов, которые пишут код. Она хранит, что происходило при разработке проекта: какие возникали проблемы, какие подходы пробовали, какие исправления сработали и какие решения приняли. Новая сессия агента читает эту память и не начинает с нуля.
Главное по README:
- Всё локально: память лежит в обычной папке
.projectmem/внутри репозитория. Облака, аккаунта и телеметрии нет. Единственный сетевой запрос — проверка обновлений, и она включается вручную; - Типизированные события: проблемы, попытки (неудачные, частичные, удачные), исправления, решения и заметки, а не просто история чата;
- Предупреждение перед коммитом:
pjm precheckсрабатывает, если вы собираетесь повторить подход, который уже провалился, или трогаете файл с нерешённой проблемой; - MCP-сервер с 17 инструментами. Чтение:
get_summary,get_project_map,precheck_file,search_events,get_contextи другие. Запись:log_issue,record_attempt,record_fix,add_decision,add_note; - Один сервер на много проектов (с версии 0.3.0): каждый вызов сам определяет проект по реестру;
- Дашборды для просмотра памяти.
Кому подойдёт
- Тем, кто долго работает с Claude, Cursor или Codex над одним репозиторием и устал заново объяснять контекст.
- Командам: обобщённые файлы памяти коммитятся, и ИИ коллеги получает накопленный опыт.
- Тем, кто хочет держать память агента у себя, а не в облаке.
Другие серверы — в категории разработка.
Установка
Три команды:
pip install projectmem
cd your-project
pjm initpjm init создаёт .projectmem/, ставит три git-хука (предупреждения перед коммитом, классификация после коммита, отслеживание слияний) и запускает наблюдение за файлами. Основная команда — projectmem, pjm — её короткий псевдоним. Для проектов, созданных до версии 0.2.0, выполните pjm doctor --fix: команда зарегистрирует их в реестре.
Подключение к клиентам
Конфиги приведены дословно из README. Указывайте абсолютный путь к своему python: узнать его можно командой which python. Клиенты не всегда наследуют PATH оболочки. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"projectmem": {
"command": "/opt/anaconda3/bin/python",
"args": ["-m", "projectmem.mcp_server"]
}
}
}В Cursor тот же JSON можно добавить глобально: Settings → Tools & MCPs → Add Custom MCP. Для Codex README советует уровень рассуждений не ниже medium, иначе модель может пропустить начальные вызовы. Claude Desktop и Antigravity подключаются похожим блоком. После правки клиент нужно полностью закрыть и открыть заново.
Проверка
Выполните pjm doctor — команда покажет незарегистрированные и устаревшие проекты. В клиенте попросите агента вызвать get_instructions(), get_summary() и get_project_map(). При первом использовании клиент спросит разрешение на каждый инструмент — это ожидаемо.
Примеры задач
Перед правкой src/auth.py проверь историю неудач по этому файлу через precheck_file.Запиши решение: переходим на PostgreSQL вместо SQLite, и почему.Риски
projectmem пишет в репозиторий: создаёт .projectmem/, устанавливает git-хуки и запускает фоновое наблюдение за файлами. Агент сам записывает события через инструменты записи. Что важно знать:
- по умолчанию обобщённые файлы (
summary.md,PROJECT_MAP.md,AI_INSTRUCTIONS.md,issues/) коммитятся и попадают в репозиторий. Не допускайте в память секретов и внутренних деталей, если репозиторий публичный; - для полной приватности добавьте строку
.projectmem/в.gitignore; - сервер, закреплённый за одним репозиторием через
--root, отказывается писать за его пределами. Это более строгий режим; pjm doctorничего не сканирует без запуска и ничего не пишет без флага--fix.
Частые вопросы
Нужно ли настраивать сервер для каждого проекта?
Нет, с версии 0.3.0 один конфиг обслуживает все проекты, на которых выполнен pjm init.
Уходят ли данные в облако?
Нет, память хранится в папке .projectmem/ внутри репозитория.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.