Graphicle, 코드 그래프와 메모리 통합한 로컬 MCP 서버 공개

개요

Graphicle은 코딩 에이전트를 위해 코드 그래프 매핑과 영구 프로젝트 메모리를 결합한 Graphify의 Rust 기반 포팅 버전이다. API 키, 계정, 텔레메트리 없이 로컬에서 작동하며 macOS와 Linux를 지원한다(Windows 지원 예정). **Model Context Protocol (MCP)**을 통해 Claude Code, Cursor, Codex, VS Code, Claude Desktop 등 주요 AI 코딩 환경과 호환된다.

주요 기능

• 통합 아키텍처: 기존처럼 별도의 코드 그래프 도구와 메모리 서버를 분리할 필요 없이, 단일 설치, 단일 SQLite 파일, 하나의 MCP 서버로 구성된다. Python, Docker, 외부 데이터베이스 서버가 불필요하다.
• 코드 그래프 및 메모리: tree-sitter 파싱을 사용해 모델 호출 없이 저장소를 코드 그래프로 매핑하고, 프로젝트 문서, 결정 사항, 과거 에이전트 세션을 검색 가능한 메모리로 저장한다.
• 인용된 컨텍스트: graphicle context 명령어와 MCP 도구는 토큰 예산 내에서 파일 및 줄 번호가 포함된 발췌문을 반환하여 에이전트가 근거 있는 증거를 확보하도록 한다.
• 세션 캡처: 완료된 에이전트 턴이 저장되며, 승인된 메모리는 새 세션 시작 시 로드된다. 메모리는 특정 함수에 고정되며, 기본 코드가 변경되면 만료(stale) 상태로 표시된다.

성능 벤치마크

원본 Graphify 도구와의 성능 비교 결과:

• Kubernetes 저장소(약 31,000개 파일): Graphicle 0.1.0 엔진은 추출을 3분 18초에 완료했다. Graphify 0.9.88은 26분 38초가 소요됐다. 두 도구 모두 동일한 그래프(256,329개 노드, 1,400,392개 엣지)를 구축했다.
• Django 저장소: Graphicle 프리릴리스 빌드는 코드 전용 추출에 7.5초가 걸렸으며, Graphify 0.9.77은 72.8초(5회 교대 실행 중앙값)가 소요됐다.
• 메모리 시스템: 단일 오픈 모델을 판정자로 사용해 7개의 다른 메모리 시스템과 비교한 벤치마크에서, Graphicle 프리릴리스 빌드는 3개의 개발 세트에서 어떤 경쟁사보다도 뒤처지지 않았다.

프라이버시 및 설정

• 로컬 우선: 데이터는 단일 SQLite 저장소에 로컬로 저장된다. 네트워크 사용은 기본적으로 루프백으로 제한되며, 사용자가 모델(Anthropic, OpenAI, Ollama)을 명시적으로 구성하거나 전체 문서 추출 등 특정 기능을 사용할 때만 외부 API 호출이 발생한다.
• 보안: .gitignore를 준수하고 자격 증명을 건너뛰며, 세션 캡처에서 민감한 데이터를 마스킹한다. 메모리 또는 세션 삭제 시 파생 데이터도 함께 제거되며 해시 체인 영수증을 제공한다.
• 설치: brew install graphicle-ai/tap/graphicle 또는 설치 스크립트를 통해 설치할 수 있다. graphicle setup 명령어는 인덱싱, 에이전트 클라이언트 연결, Git 훅 설치를 자동화하며, graphicle disconnect로 되돌릴 수 있다.

라이선스

Graphicle은 Apache-2.0 라이선스로 배포되어 개인 및 상업적 용도로 무료 사용이 가능하다. 기본 코드 그래프 엔진에 대해 Safi Shamsi와 Graphify 기여자들에게 크레딧을 부여한다.