Personal Brain MCP v0.2

PostgreSQL-backed long-term personal-memory MCP сервер. Поддерживает локальный Docker PostgreSQL и удаленный Neon PostgreSQL, а также предоставляет Streamable HTTP MCP эндпоинт для размещения на Render.

Инструменты MCP

• get_personal_contextн* save_memoryн* query_personal_database — только SQL только для чтения, сгенерированный моделью

• update_context_manifestн

Related MCP server: hippocampus-mcp

Удаленные конечные точки

• MCP: POST /mcp (Streamable HTTP)

• Проверка работоспособности: GET /healthн

Локальная разработка с Docker PostgreSQL

cp .env.example .env
# Remove/comment DATABASE_URL in .env to use the local Docker settings.
docker compose up -d
npm install
npm run check
npm run dev

По умолчанию сервер прослушивает http://localhost:10000.

Neon / Render

Установите эти переменные окружения в Render:

DATABASE_URL=<Neon connection string>
MCP_API_KEY=<long random secret, recommended>
USER_ID=main
USER_NAME=<your display name>
USER_LANGUAGE=ko
USER_TIMEZONE=Asia/Seoul

Render автоматически предоставляет PORT. Приложение привязывается к 0.0.0.0:$PORT.

Команда сборки:

npm install && npm run build

Команда запуска:

npm start

Пут проверки работоспособности:

/health

После развертывания конечная точка MCP:

https://<your-render-service>.onrender.com/mcp

Если устновлен MCP_API_KEY, клиенты должны отправлять:

Authorization: Bearer <MCP_API_KEY>

Инициализация базы данных

При запуске приложение безопано создает необходимые таблицы и индексы, если они еще не существуют. pgvector является опциональным в v0.2;ошибка его включения не препятствует запуску.

Безопасность

• .env игнорируется Git.

• Никогда не фиксируйте строки подключения Neon, пароли, API-ключи или токены.

• query_personal_database принимает только один запрос SELECT/WITH, выполняет его в транзакции только для чтения и ограничивает вывод 100 строками.