Personal Brain MCP v0.2

PostgreSQL 기반 장기 개인 메모리 MCP 서버입니다. 로컬 Docker PostgreSQL과 원격 Neon PostgreSQL을 지원하며, Render에서 호스팅하기 위한 Streamable HTTP MCP 엔드포인트를 제공합니다.

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행으로 제한합니다.