TL;DR

이 레포는 MCP 서버와 CLI를 갖춘 에이전트용 지식 브레인 소프트웨어로, 하이브리드 검색과 자가 연결 지식 그래프에 합성 레이어를 더해 에이전트에게 실제 답변과 갭 분석을 제공하도록 설계되어 있습니다. 로컬 개인용은 PGLite로 2초짜리 DB 초기화가 가능하고 팀용 대규모는 Postgres+pgvector로 확장하는 명확한 경로를 제공합니다. Claude Code·Codex 등 주요 MCP 클라이언트와 즉시 연동할 수 있으며 설치 권장 경로는 에이전트 자동화된 절차로 약 30분 내 기본 동작을 검증할 수 있습니다. 도입 전에는 전역 npm 패키지명 충돌(gbrain npm)과 권한·데이터 범위 설정, 그리고 외부 채널(예: 이메일·Slack) 미수집 범위를 고려해 데이터 가시성과 보안 경계를 설계해야 합니다.

핵심 포인트

• 레포는 에이전트용 'brain layer'로서 작동하며, MCP 프로토콜(표준 stdio/HTTP)과 로컬 CLI를 통해 에이전트에 메모리와 합성 응답을 제공하는 소프트웨어입니다. 설치 경로는 에이전트가 자동으로 따라가도록 설계되어 있고, Claude Code나 Codex 같은 MCP 클라이언트에 한 줄로 연결할 수 있어 로컬 개발 환경이나 에이전트 플랫폼에 빠르게 붙일 수 있습니다. README에 따르면 PGLite로 2초 내 DB 준비가 가능하고 에이전트 주도 설치로 약 30분 만에 기본 동작을 확인할 수 있습니다.
• 핵심 기술 스택은 하이브리드 검색과 자가 연결 지식 그래프, 합성 레이어로 구성되며, 검색은 벡터(HNSW on pgvector) + BM25 + reciprocal-rank fusion 같은 다계층 접근을 사용합니다. 페이지 쓰기 시엔 엔티티 참조를 추출해 타입화된 엣지(attended, works_at 등)를 생성하고 LLM 호출 없이 그래프를 확장하므로 그래프 기반 멀티홉 질의가 벡터 검색만보다 정확도가 크게 향상됩니다. 이 구성은 검색→합성→갭 분석→야간 동기화(크론 드림 사이클)를 연결하는 루프를 통해 지식 일관성과 인덱스 품질을 유지하도록 설계되어 있습니다.
• 운영·배포 선택지가 명확하게 나뉘어 있어 개인용 소규모 브레인은 PGLite(PG via WASM)로, 팀·대규모는 Postgres+pgvector로 확장하도록 되어 있습니다. 인증 및 권한은 HTTP 서버 모드에서 OAuth 2.1과 대시보드, scope-게이팅(read/write/admin)으로 처리하며 조직 단위 사용을 염두에 둔 다중 브레인·소스 토폴로지가 문서화되어 있습니다. 다만 README가 강조하는 설치 권장 경로가 에이전트 자동 설치라는 점과 'gbrain'이라는 npm 패키지명이 다른 패키지와 충돌할 수 있다는 경고를 반드시 유념해야 합니다.
• 에코시스템 연동 면에서 Claude Code, Codex, Cursor, Perplexity, ChatGPT 등 주요 MCP 클라이언트를 직접 지원하고 통합 레시피(임베딩 제공자, reranker, Twilio voice 등)를 갖추고 있습니다. 43개의 사전 구성된 'skills'와 평가 프레임워크(gbrain eval)가 포함되어 있어 실제 운영중인 브레인에서 재현 가능한 회귀·품질 검사를 돌릴 수 있습니다. 조직용 공유 브레인으로 사용할 때 권한 분리·검색 격리·데이터 범위 제어가 설계 전반에 스레딩되어 있어 팀 도입 시 보안·접근성 요구에 맞출 수 있습니다.

벤치마크