YourMemory — MCP-сервер для Claude Code: что делает и как установить
Долговременная память для ИИ-агентов с забыванием по кривой Эббингауза и графом связей. Помогает сохранять рабочий контекст и факты между сессиями без раздувания базы.
claude mcp add --env PYTHONIOENCODING=<PYTHONIOENCODING> --transport stdio yourmemory -- uvx yourmemoryЧто делает YourMemory
Сервер сохраняет факты о проекте и диалогах локально в каталоге ~/.yourmemory/. По умолчанию используется встроенная база DuckDB, а для совместной работы доступен Postgres с расширением pgvector. Накопленные связанные записи автоматически объединяются в общие сводки, а исходные отправляются в архив.
Поиск комбинирует векторные эмбеддинги, алгоритм BM25 и граф сущностей, что помогает находить связанные детали без прямого совпадения слов. Старые невостребованные воспоминания постепенно угасают со временем, а при частом обращении закрепляются. Каждое чтение, добавление или удаление фиксируется в неизменяемом журнале с цепочкой хэшей.
Для запуска требуется Python от версии 3.11 до 3.14 и токен с сайта yourmemoryai.xyz. Без предварительной регистрации ключа через консольную команду запустить сервер не получится.
Какие задачи решает
- сохранять контекст и пользовательские предпочтения между разными сессиями
- сжимать накопившиеся разрозненные факты в чистую сводку
- связывать сущности и концепции через граф для непрямого поиска
- контролировать операции с памятью через защищённый журнал изменений
Примеры запросов агенту
- Вспомни, какие архитектурные соглашения мы зафиксировали на прошлой неделе.
- Сохрани решение по переходу на новую схему очередей сообщений.
- Удали из памяти устаревшие заметки по закрытому сервису авторизации.
Как установить YourMemory
Командой платформы
claude mcp add --env PYTHONIOENCODING=<PYTHONIOENCODING> --transport stdio yourmemory -- uvx yourmemoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from yourmemory <команда>
Командой платформы
codex mcp add yourmemory --env PYTHONIOENCODING=<PYTHONIOENCODING> -- uvx yourmemoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from yourmemory <команда>
Файл настроек
{
"mcpServers": {
"yourmemory": {
"command": "uvx",
"args": [
"yourmemory"
],
"env": {
"PYTHONIOENCODING": "<PYTHONIOENCODING>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from yourmemory <команда>
Файл настроек
{
"servers": {
"yourmemory": {
"type": "stdio",
"command": "uvx",
"args": [
"yourmemory"
],
"env": {
"PYTHONIOENCODING": "<PYTHONIOENCODING>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from yourmemory <команда>
Командой платформы
gemini mcp add -e PYTHONIOENCODING=<PYTHONIOENCODING> yourmemory uvx yourmemoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from yourmemory <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о YourMemory
Как установить YourMemory в Claude Code?
Выполните команду claude mcp add yourmemory -- uvx yourmemory. Если требуется настроить кодировку вывода, используйте команду claude mcp add --env PYTHONIOENCODING=<PYTHONIOENCODING> --transport stdio yourmemory -- uvx yourmemory.
Где YourMemory хранит сохранённые данные?
Файлы по умолчанию записываются в локальный каталог ~/.yourmemory/ через DuckDB. Для распределённой работы команды можно подключить Postgres с установленным расширением pgvector.
Что нужно подготовить перед запуском YourMemory?
Требуется интерпретатор Python версии 3.11–3.14 и токен с сайта yourmemoryai.xyz. После инсталляции пакета выполните в терминале yourmemory-register <your-token>, а затем запустите yourmemory-setup.