memo-mcp

memo-mcp — это защищённый шлюз MCP со Streamable HTTP для частного самостоятельного Mem0 REST API. Он предоставляет небольшой набор неразрушающих инструментов для работы с памятью, сохраняя Mem0, PostgreSQL и внутренние учётные данные API вне публичной сети.

Он создан как эталонная реализация для одной доверенной области памяти. Перед тем как разрешить его нескольким людям, внедрите серверный адаптер политик, который выводит область памяти из аутентифицированного членства. Никогда не позволяйте браузеру или MCP-клиенту выбирать MEMORY_SCOPE.

Модель безопасности

• Mem0 остаётся закрытым; через обратный прокси открывайте только этот шлюз.

• Браузерные клиенты могут использовать интроспекцию токенов OAuth/OIDC с точной проверкой эмитента, аудитории, неизменяемого субъекта и областей.

• memo_remember_fact требует mem0.write для OAuth-клиентов.

• Шлюз намеренно не предоставляет инструмент удаления памяти. Удаление выполняется через отдельный, закрытый административный процесс с явным одобрением.

• Шлюз отклоняет распространённые форматы учётных данных и закрытых ключей до их записи в память. Это подстраховка, а не замена политике оператора.

• Вызывающая сторона никогда не должна выбирать собственную область памяти. В многопользовательских развёртываниях эта область должна определяться доверенным приложением на основе серверного членства.

Related MCP server: memex

Быстрый старт

1. Скопируйте .env.example в .env и замените каждый заполнитель своими собственными закрытыми значениями. Не коммитьте .env.

2. Создайте частную сеть Docker и запустите сервис командой docker compose -f compose.example.yml up -d --build.

3. Прокси с HTTPS направляйте только к шлюзу. Не публикуйте Mem0, PostgreSQL и ни одной заполненный файл окружения наружу.

4. Убедитесь, что защищённые метаданные ресурса возвращают 200, когда OAuth включён, и что анонимный запрос /mcp возвращает 401.

Инструменты

• memo_search_memory

• memo_remember_fact

Конфигурация

Смотрите .env.example. Значения PUBLIC_MCP_URL, MCP_ALLOWED_HOSTS и MCP_ALLOWED_ORIGINS должны описывать ваш собственный HTTPS-эндпоинт. Шлюз обращается к нижележащему Mem0 API с помощью X-API-Key.

MCP_ALLOWED_HOSTS обязателен. Контекст сборки контейнера исключает .env, метаданные Git и локальные артефакты Python, поэтому они случайно не попадут в образ.

Development

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m unittest discover -s tests -v

Этот проект использует официальный Python MCP SDK.