memstate-ai/memstate-mcp

Выполняет мягкое удаление памяти по keypath. Создаёт tombstone-версию с сохранением полной истории. Память можно восстановить, записав новое значение по тому же keypath. **ИСПОЛЬЗУЙ ЭТО КОГДА:** нужно удалить устаревшие или некорректные записи, очистить поддерево keypath или пометить память как больше неактуальную. **НЕ ДЛЯ:** обновления содержимого (используй memstate_set или memstate_remember, чтобы перезаписать новыми данными). memstate_delete(project_id="myapp", keypath="config.old_setting") memstate_delete(project_id="myapp", keypath="config", recursive=true) → удаляет config и все дочерние записи История сохраняется. Чтобы увидеть удаление в цепочке версий, используй memstate_history. Keypath добавляется с префиксом автоматически.

Мягко удаляет проект целиком и все его воспоминания. Создаёт tombstone-версии для каждого воспоминания, сохраняя полную историю. Проект скрывается из списков, но его можно восстановить, создав новый проект с тем же ID. **ИСПОЛЬЗУЙТЕ ЭТО, КОГДА:** нужно удалить все воспоминания для проекта, например, для очистки тестовых данных или вывода проекта из эксплуатации. memstate_delete_project(project_id="old-project") Все воспоминания получают отдельные tombstone-версии. История сохраняется через memstate_history.

Просматривать и извлекать воспоминания. Используйте ДО начала задач, чтобы получить существующие знания. **ИСПОЛЬЗУЙТЕ ЭТО, КОГДА:** нужно прочитать то, что уже сохранено - список проектов, просмотреть дерево проекта или получить содержимое по keypath. **НЕ ДЛЯ:** сохранения нового содержимого (используйте memstate_remember для markdown/сводок, memstate_set для одного значения keypath). memstate_get() → список всех проектов memstate_get(project_id="myapp") → полное дерево проекта memstate_get(project_id="myapp", keypath="database") → поддерево memstate_get(project_id="myapp", keypath="db", include_content=true) → с полным содержимым memstate_get(project_id="myapp", keypath="config", at_revision=2) → переход к версии 2 Keypath автоматически дополняется префиксом. По умолчанию recursive=true. Используйте at_revision с номерами версий из memstate_history.

Просмотр истории версий для keypath или цепочки памяти. Используйте, когда нужно увидеть, как значение менялось со временем. **ИСПОЛЬЗУЙТЕ ЭТО ДЛЯ:** отладки прошлого состояния, аудита изменений или восстановления предыдущего значения. **НЕ ДЛЯ:** чтения текущего содержимого (используйте memstate_get) или сохранения (используйте memstate_remember или memstate_set). memstate_history(project_id="myapp", keypath="config.database.port") Возвращает все версии с временными метками и номерами версий; последняя помечена is_latest=true. Используйте номера версий с memstate_get(at_revision=N), чтобы перемещаться во времени к любому прошлому состоянию.

Сохраняет markdown, сводки задач или любой текст. Сервер автоматически извлекает ключевые пути (keypaths) и создаёт структурированные записи. Это ПРЕДПОЧТИТЕЛЬНЫЙ способ сохранения информации. **ИСПОЛЬЗУЙ ЭТО КОГДА:** Нужно сохранить сводки задач, заметки встреч, документацию или любой текст с несколькими фактами. Сервер сам занимается организацией, обнаружением конфликтов и управлением версиями. **НЕ ДЛЯ:** Установки одного конкретного ключевого пути (keypath) с коротким значением (например, config.port = "8080") — для этого используй memstate_set. memstate_remember(project_id="myapp", content="## Сводка задач\n- Добавлен OAuth\n- Файлы: auth.go, middleware.go", source="agent") memstate_remember(project_id="myapp", content="Архитектурное решение: перешли на JWT-токены для управления сессиями") Ограничение по содержимому: 100 000 символов. Обработка асинхронная (~15-18 с); job_id возвращается сразу.

Ищет воспоминания по смыслу (семантический поиск). Используй ДО того, как начнёшь задачу, если не знаешь точный keypath. **ИСПОЛЬЗУЙ ЭТО КОГДА:** нужно найти подходящие воспоминания по теме или смыслу, а не по точному keypath. **НЕ ДЛЯ:** сохранения контента (для markdown/суммари используй memstate_remember, для одного значения по keypath — memstate_set). memstate_search(query="как настроена аутентификация", project_id="myapp") memstate_search(query="настройки подключения к базе данных", project_id="myapp") Возвращает суммари с оценками схожести. Используй memstate_get(project_id="...", keypath="...", include_content=true), чтобы получить полное содержимое результата.

Устанавливает одно короткое значение по заданному keypath. Только для простых фактов вида ключ=значение: конфигурация, статус или номера версий. **ИСПОЛЬЗУЙ ЭТО КОГДА:** Нужно сохранить ОДНО конкретное значение по известному keypath (например, номер порта, флаг статуса, строка версии). **НЕ ДЛЯ:** Сводок задач, markdown или текста с несколькими фактами — используй memstate_remember. memstate_set(project_id="myapp", keypath="config.database.port", value="5432") memstate_set(project_id="myapp", keypath="status.deployment", value="production") memstate_set(project_id="myapp", keypath="version.current", value="2.1.0") Ограничение значения: 2 000 символов. Если длиннее — используй memstate_remember. Keypath автоматически дополняется префиксом.