Firmament Open Brain

Общий «контекстный мозг» для команды Firmament, вдохновлённый OB1, но пересобранный в облегчённом виде для Railway. Это MCP-сервер (Model Context Protocol) на базе Postgres: каждый человек получает личное хранилище памяти, которое следует за ним между AI-инструментами (Claude Desktop, Claude Code, claude.ai, Cursor и т. д.). Воспоминания изолированы для каждого пользователя — ваш токен видит только ваши собственные воспоминания.

Как это работает

• Один сервис Railway (это Node-приложение) + один Railway Postgres.

• Каждый пользователь получает личный токен. Его MCP URL — https://<host>/mcp/<token>.

• Все чтения и записи памяти привязаны к пользователю, которому соответствует этот токен. Токены хранятся в хешированном виде (SHA-256).

• Поиск — это полнотекстовый поиск Postgres с запасным вариантом по подстроке — ключи для embedding API не нужны.

Related MCP server: LedgerMem MCP Server

Предоставляемые MCP-инструменты

Подключение клиента

Claude Code:

claude mcp add --transport http openbrain https://<host>/mcp/<your-token>

Claude Desktop / claude.ai: Настройки → Коннекторы → Добавить пользовательский коннектор → вставьте https://<host>/mcp/<your-token>.

Cursor: Настройки → MCP → Добавить сервер, укажите тип http, тот же URL.

Затем просто говорите: «запомни, что ...» / «что ты знаешь о ...». Хорошая привычка — начинать сессии с фразы «проверь мой open brain для контекста по <теме>».

Администрирование (выпуск пользователей)

Требуется переменная окружения ADMIN_TOKEN; передавайте её в виде Bearer-токена.

# create a user (returns their token + MCP URL — shown only once)
curl -X POST https://<host>/admin/users \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jack Wright"}'

# list users
curl https://<host>/admin/users -H "Authorization: Bearer $ADMIN_TOKEN"

# delete a user (and all their memories)
curl -X DELETE https://<host>/admin/users/<id> -H "Authorization: Bearer $ADMIN_TOKEN"

Развёртывание (Railway)

Переменные окружения для сервиса приложения:

• DATABASE_URL — ссылка на Railway Postgres

• ADMIN_TOKEN — длинная случайная строка (аутентификация admin API)

• DATABASE_SSL — установите false, если подключение идёт через приватную сеть Railway

Разверните с помощью railway up из этого каталога. Схема создаётся автоматически при запуске.

Замечания по безопасности

• Токен живёт в URL. Именно благодаря этому подключение сводится к одной вставке, и для небольшой доверенной команды это приемлемо, но относитесь к URL как к паролю: не делитесь им и не вставляйте его в групповые чаты.

• Потерянный токен → удалите пользователя и выпустите новый (воспоминания привязаны к строке пользователя, поэтому удаление пользователя удаляет и его воспоминания — при необходимости сначала экспортируйте).