Personal Brain MCP v0.2

Un servidor MCP de memoria personal a largo plazo respaldado por PostgreSQL. Soporta PostgreSQL local con Docker y Neon PostgreSQL remoto, y expone un endpoint MCP HTTP Streamable para alojamiento en Render.

Herramientas MCP

• get_personal_context

• save_memory

• query_personal_database — solo SQL de solo lectura generado por el modelo

• update_context_manifest

Related MCP server: hippocampus-mcp

Endpoints remotos

• MCP: POST /mcp (HTTP Streamable)

• Health check: GET /health

Desarrollo local con 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

El servidor escucha en http://localhost:10000 por defecto.

Neon / Render

Establece estas variables de entorno en 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 proporciona PORT automáticamente. La aplicación se vincula a 0.0.0.0:$PORT.

Comando de compilación:

npm install && npm run build

Comando de inicio:

npm start

Ruta de health check:

/health

Después del despliegue, el endpoint MCP es:

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

Si MCP_API_KEY está configurada, los clientes deben enviar:

Authorization: Bearer <MCP_API_KEY>

Inicialización de la base de datos

Al iniciar, la aplicación crea de forma segura las tablas e índices necesarios si aún no existen. pgvector es opcional en v0.2; si no se puede habilitar, no impide el inicio.

Seguridad

• .env está ignorado por Git.

• Nunca confirmes cadenas de conexión de Neon, contraseñas, claves API o tokens.

• query_personal_database solo acepta una consulta SELECT/WITH, la ejecuta en una transacción de solo lectura y limita la salida a 100 filas.