Graphthulhu MCP 서버: Logseq/Obsidian 지식 그래프 메모리 제공

Graphthulhu는 AI 에이전트에게 Logseq 또는 Obsidian 볼트에 대한 완전한 읽기-쓰기 접근 권한을 제공하는 MCP 서버입니다. 텍스트 청크를 벡터로 임베딩하는 대신, 에이전트는 속성과 [[링크]]가 있는 구조화된 페이지를 작성하여 지식 그래프를 메모리로 생성합니다.

작동 방식

시스템은 에이전트 메모리를 디스크에 일반 마크다운 파일로 저장합니다. 모든 페이지에는 유형(프로젝트/결정/연구/교훈/정보), 상태, 생성/수정 타임스탬프가 있습니다. 에이전트는 학습 후 작성하고, 관련 페이지를 연결하며, 속성 표준을 따릅니다. 주기적인 하트비트 동안 에이전트는 최근 일일 노트를 검토하고 중요한 내용을 그래프로 승격시킵니다.

한 달 후 결과

404페이지 생성
페이지 간 1,451개의 상호 참조
프로젝트는 결정에 연결되고, 결정은 연구에 연결되며, 연구는 얻은 교훈에 연결됨
메모리는 시간이 지남에 따라 더 밀도 높아지는 연결된 지식의 웹이 됨

해결된 벡터 메모리의 문제점

저자는 일반적인 벡터 기반 메모리 시스템의 세 가지 문제점을 지적합니다:

단일 각도 검색: 검색 쿼리는 메모리가 저장된 각도와 일치해야 합니다. "Fitbit 인증 실패"와 "브라우저 쿠키 문제"는 동일한 메모리일 수 있지만, 둘 다 검색하지 않으면 벡터가 연결하지 않습니다.
구조 부재: 모든 것이 동일한 가중치로 임베딩으로 저장됩니다. 핵심 선호도와 일회성 이벤트는 검색 시스템에 동일하게 보입니다.
관계 부재: 사실 A와 사실 B가 존재한다는 것을 알더라도 A가 B를 야기했다는 것을 볼 수 없다면 무용지물입니다.

지식 그래프의 장점

다중 후크 검색: 모든 [[링크]]는 검색 경로입니다. "OpenChaos"를 검색하면 프로젝트 페이지를 얻고, 링크를 따라 거버넌스 위기, 경쟁 분석, 학술 연구를 찾을 수 있습니다.
유형이 기본 제공됨: 그래프는 구조적으로 선호도와 이벤트가 다른 것임을 알고 있습니다. 학습된 감쇠율이 필요 없습니다.
지속성: 에이전트 충돌, 세션 재설정, 모델 교체 - 지식은 지속됩니다. 데이터베이스 없음, 재계산할 임베딩 없음, 유지할 벡터 저장소 없음. 버전 관리된 메모리를 위해 git으로 백업하세요.

기술적 세부사항

단일 Go 바이너리
37개의 MCP 도구
Logseq 및 Obsidian 백엔드 모두와 작동
GitHub에서 오픈소스

트레이드오프와 향후 계획

이 접근 방식은 "모든 것을 임베딩"하는 것보다 더 많은 초기 구조가 필요합니다. 에이전트는 학습 후 작성하고, 항상 관련 페이지를 연결하며, 속성 표준을 따르는 훈련이 필요합니다. 저자는 편의성 대신 깊이를 선택하고 있습니다.

향후 계획에는 그래프 위에 RAG 추가가 포함됩니다: 진입점을 찾기 위한 퍼지 의미 검색을 위해 페이지 내용을 임베딩한 다음, 그래프 순회를 사용하여 연결된 모든 것을 가져옵니다. 이는 발견을 위한 의미 검색과 컨텍스트 확장을 위한 그래프 링크의 Microsoft GraphRAG 논문 패턴을 따릅니다.

📖 전체 출처 읽기: r/openclaw