MemoryHub
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MemoryHub
MemoryHub — MCP-сервер для долговременной памяти ИИ-ассистентов. Он предоставляет инструменты для проектов и заметок, хранит данные в SQLite и принимает запросы по MCP Streamable HTTP.
Возможности
Bearer-аутентификация по API-токенам.
SHA-256 хеши токенов хранятся в SQLite; исходный токен показывается только при создании.
Scopes:
memory:read,memory:writeиmemory:admin.Проекты, поиск и получение записей памяти, обновление и архивирование.
Защита MCP транспорта от DNS rebinding.
Uvicorn за Nginx; пример systemd unit и фрагмент Nginx находятся в
deploy/.
Related MCP server: memory-vault
MCP-инструменты
Инструмент | Scope | Назначение |
|
| Проверить доступность MemoryHub |
|
| Создать проект |
|
| Получить список проектов |
|
| Сохранить запись |
|
| Найти записи по тексту, проекту и категории |
|
| Получить запись по ID |
|
| Обновить запись |
|
| Архивировать запись без физического удаления |
memory:admin разрешает операции чтения и записи. Поиск по категориям использует instructions, technical, preferences, decisions, context и notes.
Конфигурация
Настройки задаются переменными окружения. Для systemd их читает файл /etc/memoryhub/memoryhub.env; шаблон находится в .env.example.
Переменная | Значение по умолчанию | Назначение |
|
| SQLAlchemy URL базы данных |
|
| Адрес, на котором слушает Uvicorn |
|
| Порт Uvicorn |
| локальные адреса | Список разрешённых значений |
| локальные origins | Список разрешённых |
Развёртывание на Debian/Ubuntu
Пример использует /opt/memoryhub для приложения, /var/lib/memoryhub для данных и /etc/memoryhub/memoryhub.env для конфигурации.
Создайте пользователя и каталоги:
sudo useradd --system --home /opt/memoryhub --shell /usr/sbin/nologin memoryhub sudo install -d -o memoryhub -g memoryhub -m 0750 /opt/memoryhub sudo install -d -o memoryhub -g memoryhub -m 0750 /var/lib/memoryhub sudo install -d -o root -g memoryhub -m 0750 /etc/memoryhubПоместите код репозитория в
/opt/memoryhub, создайте venv и установите зависимости:cd /opt/memoryhub sudo -u memoryhub python3 -m venv venv sudo -u memoryhub venv/bin/pip install -r requirements.txtСоздайте системный env-файл и укажите ваш публичный MCP-домен в
MEMORYHUB_ALLOWED_HOSTSиMEMORYHUB_ALLOWED_ORIGINS:sudo install -o root -g memoryhub -m 0640 .env.example /etc/memoryhub/memoryhub.env sudoedit /etc/memoryhub/memoryhub.envНапример, для
https://mcp.example.com/mcpукажитеmcp.example.com,mcp.example.com:*вMEMORYHUB_ALLOWED_HOSTSиhttps://mcp.example.comвMEMORYHUB_ALLOWED_ORIGINS. При изменении пути к SQLite обновитеMEMORYHUB_DATABASE_URL; каталог базы должен быть доступен пользователюmemoryhub.Установите systemd unit. Он загружает настройки из
/etc/memoryhub/memoryhub.env:sudo install -o root -g root -m 0644 deploy/systemd/memoryhub.service /etc/systemd/system/memoryhub.service sudo systemctl daemon-reload sudo systemctl enable --now memoryhub sudo systemctl status memoryhub --no-pagerПри старте приложение создаёт отсутствующие таблицы через SQLAlchemy
create_all; существующая база не удаляется и не пересоздаётся.Настройте HTTPS reverse proxy в существующем виртуальном хосте. Фрагмент для
/mcpприведён в deploy/nginx/memoryhub-location.conf. Добавьте его в нужныйserverblock, сохранив остальные сайты и маршруты, затем проверьте и перечитайте Nginx:sudo nginx -t sudo systemctl reload nginxПрокси должен передавать
HostиAuthorization, не буферизовать SSE и допускать длительные ответы.
API-токены
Создайте отдельный токен для каждого клиента с нужными scopes. Команда печатает токен один раз — сохраните его в менеджере секретов и не отправляйте в логи или Git:
sudo -u memoryhub env MEMORYHUB_DATABASE_URL='sqlite:////var/lib/memoryhub/memory.db' \
/opt/memoryhub/venv/bin/python /opt/memoryhub/token_manager.py create \
--name claude-ai --scopes memory:read memory:writeПросмотр имён, scopes и статусов не раскрывает токены:
sudo -u memoryhub env MEMORYHUB_DATABASE_URL='sqlite:////var/lib/memoryhub/memory.db' \
/opt/memoryhub/venv/bin/python /opt/memoryhub/token_manager.py listОтзыв токена:
sudo -u memoryhub env MEMORYHUB_DATABASE_URL='sqlite:////var/lib/memoryhub/memory.db' \
/opt/memoryhub/venv/bin/python /opt/memoryhub/token_manager.py revoke --id 1Если в env-файле задан другой MEMORYHUB_DATABASE_URL, укажите то же значение в команде управления токенами.
Подключение MCP-клиента
Используйте публичный HTTPS адрес MCP endpoint, например https://mcp.example.com/mcp. Для Claude Custom Connector выберите No sign-in и добавьте обязательный request header:
Name:
authorizationValue:
Bearer <созданный API-токен>
Проверьте сервис и журнал после подключения:
sudo systemctl status memoryhub --no-pager
sudo journalctl -u memoryhub -n 100 --no-pagerЧтобы вручную проверить публичный initialize, задайте токен в переменной оболочки и отправьте JSON-RPC запрос. Не вставляйте настоящий токен непосредственно в сохраняемую команду:
read -rsp 'MemoryHub token: ' MEMORYHUB_TOKEN; echo
curl -i https://mcp.example.com/mcp \
-H "Authorization: Bearer $MEMORYHUB_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"manual-check","version":"1.0"}}}'
unset MEMORYHUB_TOKENУспешный ответ — HTTP 200, JSON-RPC result и, для stateful Streamable HTTP, заголовок Mcp-Session-Id.
Локальный запуск
Установите Python 3.11+ и зависимости. Перед запуском задайте MEMORYHUB_DATABASE_URL на локальный файл SQLite и добавьте loopback значения в MEMORYHUB_ALLOWED_HOSTS и MEMORYHUB_ALLOWED_ORIGINS. Для нового окружения приложение создаёт таблицы при прямом запуске:
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
export MEMORYHUB_DATABASE_URL='sqlite:///./memoryhub.db'
export MEMORYHUB_HOST='127.0.0.1'
export MEMORYHUB_PORT='8765'
export MEMORYHUB_ALLOWED_HOSTS='127.0.0.1,127.0.0.1:*,localhost,localhost:*'
export MEMORYHUB_ALLOWED_ORIGINS='http://127.0.0.1:8765,http://localhost:8765'
python main.pyЛицензия
Этот проект распространяется под лицензией GNU Affero General Public License v3.0
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Persistent personal memory for AI assistants — save, search, and recall across every MCP client.
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides persistent, searchable memory for MCP-compatible AI coding tools, allowing notes added from one tool to be retrieved from another.-
- AlicenseAqualityBmaintenanceProvides cross-session persistent memory for coding agents via MCP tools to store, retrieve, and manage notes with hybrid keyword/semantic search and automatic deduplication.8237 npmMIT
- AlicenseAqualityDmaintenanceProvides persistent, searchable memory for AI agents across any MCP-compatible client, storing project context, user preferences, and session learnings locally in SQLite with tools to save, retrieve, search, and manage them.129 npmMIT
- AlicenseAqualityCmaintenanceEnables coding agents to persist notes, decisions, requirements, and learnings per project in SQLite and retrieve them across sessions via search and status tools.3MIT