뇌 MCP: Claude Code 지속적 오류 메모리 시스템 오픈소스

Brain의 기능

Brain은 Claude Code에 지속적이고 프로젝트 간 메모리를 제공하는 MCP 서버입니다. 모든 프로젝트에서 발생한 모든 오류, 작동했거나 실패한 모든 해결책, 모든 코드 모듈을 저장합니다. 시간이 지남에 따라 헤비안 시냅스 네트워크를 통해 관련 개념 간의 연결을 강화하고 패턴을 발견하며, 사전에 해결책을 제안하는 방식으로 학습합니다.

작동 방식

Claude가 오류를 만나면 Brain은 다음과 같이 작동합니다:

전체 컨텍스트 포착 — 오류 메시지, 스택 트레이스, 작업 디렉토리, git 브랜치, 현재 diff, 오류를 발생시킨 명령어
매칭 — TF-IDF + 벡터 임베딩 + 시냅스 근접도의 삼중 신호 하이브리드 검색을 사용하여 지금까지 본 모든 오류와 비교
검증된 해결책 제안 — Wilson Score Intervals 기반의 신뢰도 점수와 함께
오류 연쇄 추적 — 해결 시도에서 오류가 연쇄적으로 발생하는 경우 감지
결과로부터 학습 — 해결책이 작동하면 연결이 강화되고, 실패하면 Brain은 그 또한 기억합니다

핵심 통찰: 프로젝트 A의 오류가 프로젝트 B의 버그 해결에 도움이 됩니다. 백엔드에서 수정한 그 async/await 경쟁 조건? Brain은 완전히 다른 프로젝트에서 유사한 오류를 발견할 때 동일한 패턴을 제안할 것입니다.

시냅스 네트워크

Brain은 다음과 같은 연결을 가진 가중 그래프를 구축합니다:

오류 ↔ 해결책
오류 ↔ 코드 모듈
모듈 ↔ 의존성
모든 것 ↔ 개념

연결은 반복 사용(헤비안 학습)으로 강화되고, 사용되지 않으면 시간이 지남에 따라 약화됩니다. 확산 활성화를 통해 관련 지식을 탐색할 수 있습니다:

brain explore "ENOENT file not found"

이 명령은 다음과 같은 결과를 보여줄 수 있습니다: 3개월 전의 해결책, 파일 경로를 처리하는 관련 모듈, 읽기 전에 파일 존재 여부를 확인하는 예방 규칙.

창작자의 현재 네트워크: 모든 프로젝트에 걸쳐 37,215개의 시냅스로 연결된 18,138개의 코드 모듈 — 그리고 연구 엔진에 의해 자동 생성된 3,870개의 활성 인사이트.

아키텍처

Brain은 여러 접근점을 가진 모듈식 시스템으로 구축되었습니다:

+------------------+ +------------------+ +------------------+
| Claude Code      | | Cursor/Windsurf  | | Browser/CI/CD    |
| (MCP stdio)      | | (MCP HTTP/SSE)   | | (REST API)       |
+--------+---------+ +--------+---------+ +--------+---------+
         |                    |                    |
         v                    v                    v
+--------+---------+ +--------+---------+ +--------+---------+
| MCP Server       | | MCP HTTP/SSE    | | REST API         |
| (stdio)          | | (port 7778)     | | (port 7777)      |
+--------+---------+ +--------+---------+ +--------+---------+
         |                    |                    |
         +----------+-------------+------------------------+
                    v
          +----------+-----------+
          | BrainCore            |
          | (Daemon / Services)  |
          +----------+-----------+
                    +-------+-------+--------+--------+
                    |       |       |        |        |
                    v       v       v        v        v
           Error    Code    Synapse Git      Embedding
           Memory   Brain   Network Intel    Engine
                    |       |       |        |        |
                    v       v       v        v        v
           Learn    Module  Hebbian Commit   Vector
           Engine   Score   Learn   Track    Search
                    |
                    v
           SQLite (DB)
           better-sqlite3

10개의 핵심 구성 요소가 모두 하나의 SQLite 데이터베이스(창작자 설정 기준 21.8 MB)에 연결됩니다.