Forgetful MCP
MCP-сервер долгой памяти для агентов: атомарные заметки, поиск по смыслу и граф связей между ними на SQLite или PostgreSQL
- 338 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Постоянная база хранит все, что агент решит записать, включая описания репозиториев и внутренние решения
- В режиме HTTP доступ к базе по сети защищается настройками аутентификации
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/forgetfulОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Постоянная база хранит все, что агент решит записать, включая описания репозиториев и внутренние решения
- В режиме HTTP доступ к базе по сети защищается настройками аутентификации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Forgetful запускается как MCP-сервер и дает нескольким агентам общую базу знаний. Claude Code, Cursor, Codex или собственный бот пишут в нее заметки и достают их обычным запросом на естественном языке. Сервер стартует командой `uvx forgetful-ai`, по умолчанию работает по stdio, а режим HTTP включается флагом `--transport http`. Каждая заметка хранит один факт по принципу Zettelkasten. Вместе с заголовком и текстом агент передает контекст, ключевые слова и теги. Из этих полей сервер строит эмбеддинги, ищет по смыслу, переранжирует выдачу кросс-энкодером и сам связывает похожие заметки в граф. Эмбеддинги считает локальная библиотека FastEmbed, обращений в облако не требуется. Кроме заметок, Forgetful хранит сущности (люди, организации, продукты), проекты, документы, фрагменты кода, навыки в формате SKILL.md и планы с задачами для нескольких агентов. Клиенту доступны три мета-инструмента, среди них `discover_forgetful_tools` и `execute_forgetful_tool`, поэтому описания десятков функций не занимают контекстное окно. Команда `forgetful` работает и как терминальный клиент: `forgetful memory save`, `forgetful memory search`.
Для кого. Разработчикам, которые работают сразу в нескольких агентах и хотят общую память: набросок из Claude на телефоне продолжается в Claude Code на ноутбуке.
Подходит, если
- Решения из обсуждения в Claude Desktop должны дойти до сессии в Claude Code без ручного пересказа
- Агент теряет договоренности по репозиторию между сессиями, и их приходится находить поиском по смыслу
- В базе нужно держать людей, организации и продукты вместе со связями с заметками
- Несколько агентов делят работу, а задачи с критериями приемки лежат в общем плане
- Хранение должно остаться на вашей машине: SQLite на диске и эмбеддинги без облака
Не подходит, если
- Хватает файла CLAUDE.md или AGENTS.md с парой десятков правил: отдельный сервер избыточен
- Нужен облачный сервис с поддержкой: Forgetful разворачивают сами, вместе с Docker и PostgreSQL
- Клиент не поддерживает MCP или подключение серверов запрещено политикой компании
- Машина слабая: эмбеддинги и кросс-энкодер считаются локально и нагружают процессор
Пример запроса к агенту
Запомни в Forgetful, что для редизайна магазина выбрали Stripe, и привяжи заметку к проекту «Редизайн»MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
DATABASE- SQLite по умолчанию или Postgres для общего развертывания
FORGETFUL_TOKENсекрет- Токен доступа для работы клиента `forgetful` с удаленным сервером без входа через браузер
Ограничения
- Нужен Python 3.12 или новее, для общего сервера на PostgreSQL еще Docker.
- Агент сам решает, что и когда записывать. Чтобы он обращался к памяти регулярно, в репозитории лежат скиллы `forgetful-remember` и `forgetful-recall`.
- Аутентификацию для HTTP-режима настраивают отдельно, варианты перечислены в документации FastMCP.
- Набор инструментов зависит от включенных флагов функций, актуальный список отдает `discover_forgetful_tools`.
Как отключить. Уберите блок forgetful из mcpServers в конфигурации клиента и перезапустите клиент. Данные остаются на диске: в `~/.local/share/forgetful` на Linux и macOS, в AppData на Windows. Удалите папку, если память больше не нужна. Контейнеры Docker останавливает `docker compose down`.
Частые вопросы
Как подключить Forgetful к Claude Code?
Добавьте в конфигурацию MCP блок с типом stdio, командой `uvx` и аргументом `forgetful-ai`, затем перезапустите Claude Code. Порядок для Claude Code, Cursor, Codex, Gemini CLI и OpenCode описан в `docs/connectivity_guide.md` репозитория.
Где Forgetful хранит заметки?
В SQLite на вашем диске: `~/.local/share/forgetful` на Linux и macOS, AppData на Windows. Для нескольких пользователей предусмотрен PostgreSQL через Docker Compose.
Чем Forgetful отличается от файла CLAUDE.md?
Файл с правилами читают целиком при каждом запуске. Forgetful отдает только заметки, подходящие под запрос, и показывает связанные с ними. Это удобно, когда знаний больше, чем помещается в контекст.
Нужен ли Forgetful доступ в облако?
Для заметок и поиска нет: эмбеддинги считает локальная библиотека FastEmbed, а база SQLite лежит на диске. Сеть нужна только при режиме HTTP и удаленном сервере.
Можно ли пользоваться Forgetful из терминала?
Да. Команда `forgetful` работает как клиент: `forgetful memory save` записывает заметку, `forgetful memory search` ищет, флаг `--json` дает машиночитаемый вывод. Для удаленного сервера служит `forgetful auth login --server <адрес>`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер долговременной памяти на вашем сервере: хранит предпочтения и решения между разговорами в Claude Code и Cursor
Постоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
MCP-сервер долговременной памяти для агентов: поиск, запись и исправление фактов между сессиями в облаке или в локальном ядре
MCP-сервер долгой памяти для агентов: сжимает диалоги в атомарные факты, разрешает местоимения и привязывает время к абсолютным датам
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Forgetful (эта карточка) | нет | не нужна | 338 | |
| Basic Memory | нет | не нужна | 4 509 | хранит память в локальных Markdown-файлах, а Forgetful держит атомарные заметки в SQLite или PostgreSQL |
| MCP Memory Service | нет | не нужна | 2 090 | самостоятельно размещаемая память с REST API и автоконсолидацией |
| agentmemory | да | не нужна | 30 160 | хуки записывают ход сессий сами, у Forgetful записью управляет агент |
Коротко о README
README открывается обзором: сервер навязывает принцип Zettelkasten и строит граф знаний автоматически. Дальше идут установка через PyPI, из исходников и Docker, подключение к агентам, раздел о терминальном клиенте, примеры на Python и таблица переменных окружения. В конце лежат ссылки на документацию и правила для вкладчиков.