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-хуки, наблюдение за файлами); обобщённая память по умолчанию коммитится.

Настройка клиентов

codex
{
    "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 init

pjm init создаёт .projectmem/, ставит три git-хука (предупреждения перед коммитом, классификация после коммита, отслеживание слияний) и запускает наблюдение за файлами. Основная команда — projectmem, pjm — её короткий псевдоним. Для проектов, созданных до версии 0.2.0, выполните pjm doctor --fix: команда зарегистрирует их в реестре.

Подключение к клиентам

Конфиги приведены дословно из README. Указывайте абсолютный путь к своему python: узнать его можно командой which python. Клиенты не всегда наследуют PATH оболочки. Подробнее — в инструкции как подключить MCP.

.cursor/mcp.json
{
  "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

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники