mem-agent-mcp — локальная память для агента

Установка

Работает в

• Claude Code
• Claude Desktop
• SourceCraft
• Koda
• Coddy

Ручная установка

make install
make setup
make run-agent
make generate-mcp-json

Что делает

Сервер открывает агенту один инструмент, use_memory_agent: агент задает вопрос, а локальная модель mem-agent от Dria ищет ответ в папке с заметками и возвращает его. Заметки лежат в Markdown-файлах и связаны ссылками в духе Obsidian. Главный файл `user.md` описывает вас и ваши связи, а каждый объект, будь то человек или компания, получает отдельный файл в папке `entities`. Править заметки руками можно без перезапуска сервера. Модель работает на вашем компьютере. На macOS она запускается через LM Studio с бэкендом Metal, на Linux с видеокартой через vLLM. На ARM64 Linux vLLM по умолчанию не ставится: там модель берут через OpenRouter, OpenAI или прокси LiteLLM. Модель доступна в версиях 4 бита, 8 бит и bf16. Память можно наполнить готовыми коннекторами. Они разбирают выгрузку истории ChatGPT, экспорты Notion и Nuclino, а также читают репозитории GitHub и папки Google Docs через API. Помогает мастер `make memory-wizard`. К ответам можно добавлять фильтры, например запрет раскрывать точный возраст или адреса почты: фильтры хранятся в файле `.filters` и подхватываются на лету.

Для кого. Для тех, кто ведет личную базу заметок в Markdown и хочет спрашивать ее у Claude или другого клиента, не отдавая записи внешней модели.

Пример запроса к агенту

Спроси у памяти, что я записывал про Acme Corp и кто из контактов там отвечает за закупки.

MCP

Транспорт

stdio, http

Авторизация

не нужна

Ограничения

Поддерживаются macOS с бэкендом Metal и Linux с видеокартой. Для папки mcp_server в `pyproject.toml` указан Python 3.11. Перед запуском сервера нужно установить LM Studio или vLLM, выбрать папку с памятью командой `make setup` и стартовать модель командой `make run-agent`: без запущенной модели сервер отвечать не сможет. На ARM64 Linux нужна внешняя модель или прокси.

Папка памяти должна следовать структуре с файлом `user.md` и каталогом `entities`, а ссылки между файлами нужно писать строго в формате с двойными скобками. Коннекторы к GitHub и Google Docs требуют токена доступа, токен Google живет около часа. Репозиторий не обновлялся с ноября 2025 года.

Доступность Hugging Face и сервисов ChatGPT из России при подготовке карточки не проверялась.

Как отключить. Удалите запись mem-agent из конфигурации клиента, для Claude Code это `claude mcp remove mem-agent`, и остановите модель. Папка с заметками остается на диске и принадлежит вам. Если вы открывали сервер наружу через туннель, закройте и его.

Коротко о README

Документ коротко представляет сервер, перечисляет поддерживаемые платформы и ведет по шагам установки: `make check-uv`, `make install`, `make setup`, `make run-agent` и `make generate-mcp-json`. Затем описана структура памяти с примерами `user.md` и файлов объектов, фильтры и таблица коннекторов с командами и инструкциями по получению выгрузок и токенов. Отдельные разделы объясняют подключение к Claude Code и ChatGPT, а в конце даны советы по диагностике и заготовка нового коннектора на Python.