Реестр отечественного ПО | Документация

Программный комплекс управления долговременной памятью интеллектуальных агентов «ММВ» (Managed Memory Workspace)

Правообладатель: Сингатуллин Михаил Мансурович | Версия: 1.2.0 | Дата актуализации: Сентябрь 2026 г.

Настоящий документ содержит описание функциональных характеристик программного обеспечения, а также сведения, необходимые для его установки, настройки и штатной эксплуатации.

1. Назначение и функциональные характеристики

Программный комплекс «ММВ» предназначен для создания распределённой долговременной памяти систем искусственного интеллекта и автономных агентов на базе больших языковых моделей (LLM). ПО устраняет потерю контекста («амнезию») между сессиями и предотвращает галлюцинации моделей.

Ключевые функциональные возможности:

Интеллектуальная фиксация памяти: Автоматическое извлечение фактов, архитектурных решений и пользовательских предпочтений из текстового диалога с генерацией канонических ключей и provenance-меток.
Морфологический гибридный поиск: Интеллектуальный поиск релевантных фактов с учётом грамматических форм, склонений и падежей русского и английского языков (стемминг флексий).
Управление графом знаний: Построение направленных связей между фактами (relates_to, fixes_issue, depends_on) с автоматическим разрешением конфликтов и определением устаревания.
Поддержка стандарта Model Context Protocol (MCP): Нативная интеграция со средами разработки (Cursor, VS Code, Windsurf, Claude Code), терминальными агентами и веб-интерфейсами.
Локальная отказоустойчивость (Local-First): Кэширование на базе SQLite WAL, фоновая синхронизация с облачным ядром и гарантированная доставка с защитой от дублирования (X-Idempotency-Key).
Контекстная безопасность: 4-уровневый интеллектуальный санитайзинг, энтропийный анализ Шеннона для защиты от утечек секретов и промпт-инъекций.

2. Системные требования

Параметр	Серверный компонент (Core)	Клиентский компонент (Connect Kit)
Операционная система	Linux (Ubuntu 22.04 LTS+, Astra Linux, РЕД ОС)	Linux, macOS 12+, Windows 10/11 (WSL2)
Процессор (CPU)	от 2 ядер (x86_64 / ARM64)	1 ядро
Оперативная память (RAM)	от 2 ГБ	от 256 МБ
Свободное дисковое пространство	от 10 ГБ (SSD)	от 500 МБ
Программная среда	Python 3.10+, SQLite 3.37+ (или PostgreSQL)	Python 3.9+, cURL, Bash
Сетевое подключение	HTTPS (порт 443 / 8875)	Исходящий доступ к MCP эндпоинту

3. Инструкция по установке и настройке

3.1. Развёртывание сервера MMW Core (Cloud / On-Premise)

# Клонирование репозитория
git clone https://github.com/msingatullin/mmw.git /opt/mmw
cd /opt/mmw

# Настройка виртуального окружения
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Инициализация базы данных и запуск сервиса
python3 services/agent-memory-mcp/app.py

3.2. Подключение клиентских сред через единый скрипт автоматической настройки

Для автоматической интеграции сред разработки (Cursor, VS Code, Claude Desktop / Code, Codex) выполните команду:

export MMW_CREDENTIAL="ваш_токен_доступа"
curl -fsSL https://mmwhub.ru/connect.sh | bash

Скрипт автоматически обнаружит установленные среды разработки и зарегистрирует MMW как доверенный MCP-сервер памяти.

3.3. Ручная настройка в Cursor IDE

В файле ~/.cursor/mcp.json добавьте секцию:

{
  "mcpServers": {
    "mmw": {
      "url": "https://mcp.mmwhub.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_ТОКЕН"
      }
    }
  }
}

4. Руководство по эксплуатации

После подключения MMW сервер функционирует в фоновом режиме. Взаимодействие с системой осуществляется агентами через стандартизированные методы MCP:

remember(content, title, scope) — запись факта или архитектурного решения в долгосрочную память.
search(query, limit) — морфологический и смысловой поиск по графу знаний.
forget(id) — удаление устаревшего или деактуализированного факта.
spool_status() — мониторинг состояния локального кэша и фоновой очереди отправки.

Управление арендаторами, пользователями и токенами доступа доступно авторизованным операторам через веб-интерфейс панели управления.

5. Техническая поддержка и контакты правообладателя

Техническая поддержка программного комплекса осуществляется правообладателем:

Правообладатель: Сингатуллин Михаил Мансурович
Электронная почта технической поддержки: support@mmwhub.tech
Официальный сайт: https://mmwhub.ru
Серверная инфраструктура: Размещена в РФ (Cloud.ru, Москва).