Promem-MCP

Project Memory MCP — постоянный контекст проекта для ИИ-агентов программирования. Создано DIP-RO.

pip install promem-mcp

Без базы данных. Без облака. Без демона. Без ручного управления памятью.

ContextMCP — это локально-ориентированный, MCP-нативный контекстный рантайм, который даёт ИИ-агентам программирования постоянное понимание проекта — архитектуру, правила, решения, соглашения, информацию об окружении и Git-контекст — без повторных объяснений и лишнего расхода контекста.

Быстрый старт

pip install promem-mcp

Затем зарегистрируйте ContextMCP в вашем ИИ-клиенте программирования:

# See which clients are detected
promem config

# Auto-configure a specific client (with backup + merge)
promem config cursor
promem config claude-code
promem config claude-desktop
promem config vscode

Или добавьте вручную в MCP-конфигурацию вашего клиента:

{
  "mcpServers": {
    "contextmcp": {
      "command": "contextmcp",
      "args": []
    }
  }
}

Примечание для VS Code: VS Code использует ключ "servers", а не "mcpServers". Выполните promem config vscode для правильного формата.

Вот и всё. Теперь ваш ИИ-агент программирования имеет постоянный контекст проекта.

Как это работает

Возможности

• Хранилище без настройки — база данных SQLite автоматически создается в подходящем для ОС каталоге

• Автоматическое определение проекта — язык, фреймворк, менеджер пакетов, тестовый фреймворк

• Постоянная память — правила, решения, соглашения, факты окружения, Git-интеллект

• Эффективный по токенам поиск — поиск FTS5 с бюджетом токенов, возвращает только релевантный контекст

• Отслеживание происхождения — каждая память знает, откуда она взялась и насколько она достоверна

• Редактирование секретов — ключи API, токены и пароли никогда не сохраняются и не возвращаются

• Изоляция проектов — память проектов никогда не протекает между проектами

• Обнаружение устаревшего контекста — помечает воспоминания, конфликтующие с текущим состоянием проекта

• Обнаружение противоречий — выявляет конфликтующие правила проекта

• Непрерывность сессии — сводки для передачи при переключении между агентами/сессиями

• Git-интеллект — недавние коммиты, изменённые файлы, TODOs/FIXMEs

• Диагностика окружения — версия Python, venv, полнота .env, Docker

• Локально-ориентированный — никаких сетевых запросов, облака и внешних сервисов

Инструменты MCP

CLI

contextmcp --version        # Version
promem status           # Project + storage status
promem doctor           # Health checks
promem stats            # Usage statistics
promem search "query"   # Search context
promem memory list      # List memories
promem decision "text"  # Save a decision
promem privacy          # Privacy info
promem config           # Client configuration
promem repair           # Rebuild index, optimize DB
promem reset            # Delete all data (with confirmation)

Поддержка клиентов

Ни один клиент не поддерживает полноценную автоматическую регистрацию без настройки. ContextMCP обнаруживает установленные клиенты, предлагает записать конфигурацию (с резервной копией и слиянием) и предоставляет точные сниппеты для копирования и вставки.

Конфиденциальность

• Только локально — никаких сетевых запросов

• Содержимое проекта не загружается

• Секреты редактируются — никогда не сохраняются и не возвращаются

• Без облачных зависимостей

promem privacy

Расположение хранилища

ContextMCP использует локальное для проекта хранилище — без централизованного каталога ОС и лишнего расхода места.

Каждый проект получает собственный .contextmcp/contextmcp.db. Хранилище перемещается вместе с проектом. Никакого раздувания глобального хранилища.

Добавьте .contextmcp/ в ваш .gitignore (уже включено по умолчанию в паттерны игнорирования ContextMCP).

При необходимости переопределите с помощью переменной окружения CONTEXTMCP_DATA_DIR.

Установка

# pip
pip install promem-mcp

# uv
uv add contextmcp

# pipx (global CLI)
pipx install contextmcp

Работает в venv, virtualenv, uv, pipx и системном Python.

Разработка

git clone https://github.com/contextmcp/contextmcp.git
cd contextmcp
pip install -e ".[dev]"
pytest

Лицензия

MIT