Локальный агент mmw-agent
mmw-agent — небольшая программа на Python, которую ваш MCP-клиент (Claude Code, Claude Desktop, Cursor, Codex) запускает у вас на компьютере. Она соединяет клиента с сервером памяти MMW и, только если вы явно разрешите, загружает историю ваших сессий Claude Code и Codex.
Из этой страницы вы узнаете:
- что именно делает агент и чем он отличается от прямого подключения по HTTP;
- как его запустить и проверить;
- какие у него команды и переменные окружения.
Что делает агент
Заголовок раздела «Что делает агент» MCP-клиент mmw-agent (ваш компьютер) Сервер MMW ────────── ───────────────────────── ────────── tools/list ── stdio ──▶ пересылает запрос ── HTTPS ──▶ remember, search, forget, tools/call + добавляет mmw_sync_status, validate_memory spool_status (локальные) (+ подключённые интеграции) remember: сначала на диск, потом на сервер
фоновая синхронизация ── HTTPS ──▶ история сессий (только после consent) (с вашего согласия)- Прокси ко всем инструментам сервера. Агент работает как локальный MCP-сервер по stdio и пересылает каждый запрос клиента на сервер MMW. Клиент видит ровно тот список инструментов, который отдаёт сервер, — без урезанного набора, зашитого в агент.
- Сообщает, какое приложение его запустило. В актуальном агенте агент передаёт серверу название и версию приложения из его рукопожатия (например,
Cursor/1.7.2) — для таблицы «Подключённые клиенты» в кабинете. Больше ничего о приложении и компьютере не передаётся. - Локальный инструмент
mmw_sync_status. Только чтение: показывает, дано ли согласие на загрузку истории и чем закончился последний цикл синхронизации. Выдать согласие этот инструмент не может. - Устойчивость к недоступности сервера. Если при запуске сервер не отвечает, агент сам отвечает клиенту на рукопожатие (имя сервера «MMW (офлайн, локальный агент)»), и клиент не падает. Поиск в это время возвращает понятную ошибку, а при следующем вызове агент снова пробует подключиться.
- Локальный буфер записей (с версии 0.1.9). Каждый
rememberсначала записывается на ваш диск, в~/.mmw/outbox.db, и только потом уходит на сервер. Если сервер недоступен или перегружен, ассистент получает ответ «сохранено локально» вместо ошибки, а запись доставляется в фоне, как только сервер ответит. Записи доставляются в том порядке, в каком были сделаны, и не дублируются: у каждой свой ключ идемпотентности. Отказ по существу (например, сработала защита памяти) не повторяется: ассистент видит ответ сервера. Состояние очереди показывает инструментspool_status. - Одно соединение на все вызовы (с версии 0.1.9). Агент держит соединение с сервером открытым между вызовами и не тратит время на новое TLS-рукопожатие каждый раз.
- История сессий — по согласию. Пока вы не выполнили
mmw-agent consentв терминале, с компьютера не уходит ни одной строки ваших сессий. Подробно — в разделе История сессий.
Установка и запуск
Заголовок раздела «Установка и запуск»Отдельно ставить агент не нужно: uvx скачивает его при первом запуске прямо из конфигурации клиента. Требования: Python 3.11+ и uv. Агент распространяется как колесо (wheel) с сайта MMW, в PyPI он не опубликован.
-
Получите API-ключ в кабинете app.mmwhub.ru. Ключ начинается с
mmw_. -
Добавьте агент в конфигурацию клиента. Пример для Claude Code:
Окно терминала claude mcp add mmw \-e MMW_API_KEY=mmw_ваш_ключ \-- uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agentКонфигурации для остальных клиентов — на странице Настройка агента.
-
Перезапустите клиента. В списке инструментов появятся
remember,search,search_history,forget,validate_memory,mmw_sync_statusиspool_status. -
Проверьте подключение из терминала:
Окно терминала MMW_API_KEY=mmw_ваш_ключ \uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.14-py3-none-any.whl mmw-agent status
Команда status печатает JSON. Пока согласие не дано, он выглядит примерно так:
{ "consent": null, "device_id": null, "discovered": { "claude-code": 42, "codex": 7 }, "server": { "registered": false, "sources": 0 }}consent— квитанция согласия (список клиентов и время) илиnull;device_id— идентификатор этого компьютера, создаётся при первом обращении агента к серверу или при согласии;discovered— сколько файлов сессий агент нашёл на диске (только список файлов, содержимое не читается);server— зарегистрировано ли устройство на сервере и сколько источников (файлов сессий) там уже есть. Если сервер недоступен, здесь будетerrorс причиной.
Команды
Заголовок раздела «Команды»| Команда | Что делает |
|---|---|
mmw-agent | Режим MCP-сервера по stdio. Так агент запускает ваш клиент; в этом же режиме работает фоновая синхронизация. |
mmw-agent consent | Разрешить загрузку истории сессий. Работает только в интерактивном терминале: агент покажет, сколько сессий нашёл, и попросит ввести «да». |
mmw-agent revoke | Отозвать согласие. Загрузка останавливается сразу; сервер получает уведомление, если доступен. |
mmw-agent status | Локальное согласие, найденные сессии, состояние на сервере и очередь записей (JSON). Если сервер отклонил ключ, это видно в поле server. |
mmw-agent outbox-retry | Снова отправить записи, которые не дошли до сервера (например, после исправления ключа). Доступно в текущем агенте. |
mmw-agent sync | Выполнить один цикл синхронизации сейчас и напечатать итог (JSON). Без согласия ничего не загружает. |
Переменные окружения
Заголовок раздела «Переменные окружения»| Переменная | По умолчанию | Описание |
|---|---|---|
MMW_API_KEY | — | API-ключ из кабинета. Обязателен для режима сервера, status, sync. Без него агент завершится с подсказкой. |
MMW_CREDENTIAL | — | Запасное имя для ключа: читается, только если MMW_API_KEY не задан. |
MMW_ENDPOINT | https://mcp.mmwhub.ru | Адрес сервера. Можно указывать с /mcp на конце или без. |
MMW_LANG | по адресу сервера | Язык подсказок агента: ru или en. Для mmwhub.ru по умолчанию русский, для остальных адресов — английский. |
MMW_AGENT_HOME | ~/.mmw | Каталог состояния агента: файл agent.json с идентификатором устройства и квитанцией согласия (права 0600). |
MMW_SESSIONS_HOME | домашний каталог | Где искать сессии: агент смотрит в .claude/projects и .codex/sessions внутри этого каталога. |
MMW_SYNC_INTERVAL | 15 | Пауза между циклами синхронизации, в секундах. При ошибках сети пауза растёт до 5 минут. |
MMW_SPOOL_MODE | — | async: каждый remember сразу отвечает «сохранено локально» и уходит на сервер в фоне. По умолчанию агент сначала пытается доставить запись сразу и возвращает ответ сервера. |
Подробные примеры для каждого клиента — на странице Настройка агента.