YourMemory MCP
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
- 270 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Мастер прописывает сервер в конфиги Claude Code, Claude Desktop, Cursor, Windsurf и Cline
- В локальной базе копятся ваши предпочтения и рабочие факты, в том числе личные
- Прокси на localhost:3033 видит каждый запрос к модели и ключ API, который передает клиент
Установка
- Работает в
Ручная установка
pip install yourmemoryНужен Python с 3.11 по 3.14. Есть и автономные бинарники для macOS, Linux и Windows в релизах GitHub.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Мастер прописывает сервер в конфиги Claude Code, Claude Desktop, Cursor, Windsurf и Cline
- В локальной базе копятся ваши предпочтения и рабочие факты, в том числе личные
- Прокси на localhost:3033 видит каждый запрос к модели и ключ API, который передает клиент
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
YourMemory — MCP-сервер на Python, который хранит память ИИ-агента между сессиями. Три инструмента агент вызывает сам. `recall_memory` подбирает записи по сходству и силе, `store_memory` сохраняет факт с оценкой важности и категорией и убирает дубли, `update_memory` заменяет устаревший факт. К записи можно привязать пути файлов: при работе в этой папке она получает бонус в поиске. Сила записи затухает по кривой забывания Эббингауза. Что редко вспоминают, тускнеет, а важное и частое держится. Когда накапливается много связанных фактов, они сжимаются в одну сводку, а исходники уходят в архив. Записи связаны графом по людям, местам и понятиям, поэтому поиск находит и то, о чем агент не спрашивал. В выдаче смешаны векторный поиск, BM25 и граф. Хранилище по умолчанию — локальный файл DuckDB в `~/.yourmemory`, для команд есть Postgres с pgvector. Каждое чтение, запись и удаление попадает в журнал с цепочкой хэшей, и правку задним числом видно. Есть общие пулы памяти по ролям, экспорт и удаление данных по запросу, веб-панель на `localhost:3033/ui` и граф памяти. Команда `yourmemory ask` отвечает по памяти без вызова LLM, если записей хватает. Прокси на `localhost:3033` подмешивает память в каждый вызов Anthropic или OpenAI.
Для кого. Для разработчиков, которым надоело повторять Claude Code, Cursor или Cline контекст проекта и свои предпочтения в каждой новой сессии.
Подходит, если
- Агент каждое утро забывает договоренности: стиль кода, стек, выбранную базу данных
- Нужна память, которая сама устаревает и не копит дубли
- Контекст сжался посреди задачи, и агенту надо вернуть рабочий контекст без перечитывания файлов
- Команде нужна общая память агентов с ролями и проверяемым журналом доступа
- Данные должны оставаться на вашем компьютере: хранилище локальное
Не подходит, если
- Нужно коммерческое использование: лицензия CC BY-NC 4.0 запрещает его без отдельного письменного соглашения
- Вы не готовы получать токен по почте на сайте проекта: регистрация входит в установку
- Задача разовая, и после сессии контекст не понадобится
- Нужна память без локальных моделей: сервер ставит sentence-transformers и spaCy
Пример запроса к агенту
Вспомни, какую базу данных и стиль кода мы выбрали для этого проекта, и сохрани новое решение про кэшMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
YOURMEMORY_EXTRACT_BACKEND- Значение anthropic включает облачное извлечение фактов
DATABASE_URLсекрет- Адрес Postgres с pgvector для общей или производственной установки
Ограничения
Лицензия CC BY-NC 4.0: бесплатно для личного использования, обучения, науки и открытых проектов, для коммерции нужно письменное соглашение с автором. Для установки нужен токен: его выдают на сайте yourmemoryai.xyz после подтверждения почты шестизначным кодом. Нужен Python с 3.11 по 3.14. Извлечение фактов лучше с Ollama и моделью qwen2.5:7b. Без нее работают встроенные эвристики, а облачное извлечение включается переменной `YOURMEMORY_EXTRACT_BACKEND=anthropic`. Автономный бинарник весит около 2 ГБ, потому что вкладывает обе модели. Для общих пулов команды нужен Postgres с расширением pgvector.
Как отключить. Удалите сервер из конфигов клиентов, которые прописал мастер `yourmemory-setup`, и выполните `pip uninstall yourmemory`. Память лежит в `~/.yourmemory`: удалите папку, чтобы стереть ее, или используйте встроенное удаление данных.
Частые вопросы
Как поставить YourMemory в Claude Code?
Выполните `pip install yourmemory`, затем `yourmemory-register` с токеном с сайта проекта и `yourmemory-setup`. Мастер сам находит Claude Code, Claude Desktop, Cursor, Windsurf и Cline, прописывает сервер и спрашивает, какой бэкенд хранилища взять.
Что значит, что записи затухают?
Сила записи падает по кривой забывания Эббингауза. Давно невостребованные факты слабеют и со временем вычищаются, а важные и часто нужные остаются. Затухание и чистку выполняет фоновая задача.
Где хранятся данные?
По умолчанию в локальном файле DuckDB внутри `~/.yourmemory`, граф по умолчанию лежит в `~/.yourmemory/graph.pkl`. Для команд есть Postgres с pgvector. Модели эмбеддингов работают локально.
Как проверить, что журнал доступа не подделан?
Каждая запись журнала хранит хэш предыдущей. Запрос `GET /audit/verify` проверяет цепочку и показывает строку, где она порвана. Очистка старых записей через `POST /audit/prune` не работает со сроком меньше 90 дней.
Что делает команда yourmemory ask?
Отвечает на вопрос по памяти без вызова LLM: ни токенов, ни облака. Если записей недостаточно, команда отказывается отвечать, и вопрос остается без выдуманного ответа.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель
Система долговременной памяти для AI-агентов: агент сохраняет опыт и факты, а затем находит их через встроенный MCP-сервер
MCP-сервер долгой памяти для агентов: сжимает диалоги в атомарные факты, разрешает местоимения и привязывает время к абсолютным датам
Долговременная память для ИИ-агентов: скилл и команда mindmemos сохраняют факты из диалогов и находят их в новых сессиях
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| YourMemory (эта запись) | нет | ключ необязателен | 270 | |
| agentmemory | да | не нужна | 29 985 | пишет ход сессий хуками и отдает прошлые решения через 54 MCP-инструмента |
| Hindsight | да | API-ключ | 55 871 | система долговременной памяти со встроенным MCP-сервером и без кривой забывания |
Коротко о README
README начинается с проблемы забывчивого агента и таблицы отличий, затем идут замеры автора на бенчмарках, быстрый старт, принцип работы памяти и разделы про аудит, пулы, права на данные, панели, инструменты MCP, прокси и стек. В конце описаны проверка при сбоях, лицензия и источники наборов данных.