Claude를 위한 인지 상태 재구성 MCP 서버: brain-mcp

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

사용자의 과거 사고 과정과 인지 상태를 추적하여 Claude가 맥락을 완벽히 복구할 수 있게 돕는 로컬 MCP 서버 프로젝트이다.

배경

ADHD를 겪는 개발자가 프로젝트 중단 후 복귀 시 발생하는 인지적 비용을 줄이기 위해, 단순한 사실 저장이 아닌 사고의 궤적을 기록하고 복원하는 도구를 개발하여 공유했다.

의미 / 영향

이 프로젝트는 LLM의 메모리 기능이 단순한 정보 검색(RAG)을 넘어 사용자의 사고 프로세스를 보조하는 '인지 보조기(Cognitive Prosthetic)'로 진화할 수 있음을 보여준다. 특히 MCP 표준을 활용해 로컬 데이터와 모델 간의 긴밀한 통합을 구현함으로써 개인화된 AI 워크플로우의 새로운 가능성을 제시했다.

커뮤니티 반응

작성자의 ADHD 경험에 공감하며, 단순한 메모리 이상의 '인지 보조기' 접근 방식에 대해 매우 긍정적인 반응을 보였다.

주요 논점

01찬성다수

기존 메모리 도구들이 사실 정보만 저장하는 한계를 극복하고 사고의 맥락을 복원한다는 점에서 혁신적이다.

합의점 vs 논쟁점

합의점

로컬 실행 구조가 개인정보 보호 측면에서 필수적이다.
MCP를 통한 Claude Desktop 및 Code와의 통합이 실무 활용도를 크게 높인다.

실용적 조언

pip install brain-mcp 후 brain-mcp setup claude를 실행하면 Claude Desktop과 Code 설정을 한 번에 완료할 수 있다.
맥락 전환이 잦은 개발자라면 tunnel_state를 활용해 이전 작업의 '인지적 세이브 포인트'를 생성하는 습관을 들이는 것이 좋다.
로컬 임베딩 모델을 사용하므로 API 비용 걱정 없이 대량의 과거 대화 데이터를 ingest 명령어로 색인화하여 활용 가능하다.

언급된 도구

brain-mcp추천링크

인지 상태 재구성 및 사고 궤적 추적 MCP 서버

LanceDB추천

로컬 벡터 데이터베이스 저장소

sentence-transformers추천

로컬 임베딩 생성을 위한 라이브러리

섹션별 상세

brain-mcp는 단순한 키-값 저장소 형태의 메모리를 넘어 사용자의 '인지 상태(Cognitive State)'를 재구성하는 데 초점을 맞춘다. tunnel_state 도구를 통해 특정 도메인에서 중단했던 지점, 열린 질문, 결정 사항 등을 마치 게임의 세이브 데이터를 불러오듯 복원한다. 이는 단순한 메시지 목록이 아닌 실제 인지적 저장 상태를 의미한다.

ADHD 워크플로우를 지원하기 위한 특화 기능들이 포함되어 있다. switching_cost는 주제 전환 시 발생하는 인지적 비용을 수치화하며, dormant_contexts는 사용자가 작업하다가 조용히 놓쳐버린 주제들을 다시 표면으로 끌어올린다. thinking_trajectory를 통해 아이디어가 시간에 따라 어떻게 진화했는지도 추적 가능하다.

기술적으로는 개인정보 보호와 성능을 위해 완전 로컬 환경에서 작동하도록 설계됐다. 벡터 검색을 위해 LanceDB를 사용하고 구조화된 데이터 저장을 위해 Parquet 형식을 채택했으며, sentence-transformers를 통해 로컬에서 임베딩을 생성한다. 모든 데이터는 사용자의 디스크를 떠나지 않으며 검색 리콜 속도는 약 12ms 수준이다.

Claude Desktop과 Claude Code와의 연동이 매우 간편하다. brain-mcp setup claude 명령어를 통해 설정 파일을 자동으로 작성하며, 특히 Claude Code의 세션 기록을 네이티브하게 수집하여 기존 코딩 맥락을 즉시 검색 가능한 상태로 만든다. 25개의 도구를 통해 Claude가 사용자의 과거 사고 방식을 학습하고 답변에 반영하도록 돕는다.

bash

pip install brain-mcp
brain-mcp init # 대화 탐색
brain-mcp ingest # 데이터 가져오기
brain-mcp setup claude # Claude Desktop 및 Code 자동 설정

brain-mcp 설치 및 Claude 환경 자동 설정 명령어

실무 Takeaway

brain-mcp는 단순 사실 기록이 아닌 사고의 진화 과정과 의사결정 궤적을 추적하는 25개의 인지 도구를 제공한다.
LanceDB와 Parquet를 활용한 100% 로컬 실행 구조로 데이터 보안과 약 12ms의 빠른 검색 속도를 보장한다.
what_do_i_think 기능을 통해 수개월간의 대화를 분석하여 특정 주제에 대한 사용자의 실제 견해를 합성해낼 수 있다.
brain-mcp setup claude 명령어로 Claude Desktop과 Claude Code의 MCP 설정을 자동화하여 사용자 편의성을 높였다.

언급된 리소스

GitHubbrain-mcp GitHub Repository