코드 인텔리전스 MCP 서버 구축: Joern에서 ts-morph로 전환하여 성능 360배 향상

커뮤니티 반응

작성자가 공개한 벤치마크 결과와 GitHub 저장소에 대해 긍정적인 반응이며, 특히 특정 도구(Joern)의 한계를 구체적인 수치로 증명한 점이 높게 평가받고 있다.

주요 논점

01찬성다수

TypeScript 분석에는 범용 도구보다 ts-morph 같은 전용 래퍼가 압도적으로 효율적이다.

합의점 vs 논쟁점

합의점

JVM 기반 도구의 무거운 런타임과 느린 피드백 루프는 현대적인 AI 에이전트 개발 환경에 부적합하다.
TypeScript의 타입 시스템을 정확히 이해하는 것이 코드 인텔리전스의 핵심이다.

실용적 조언

TS/JS 기반의 코드 분석 도구를 만든다면 Joern 대신 ts-morph 사용을 우선적으로 고려하라.
인덱싱 속도가 중요하다면 트랜스파일레이션 단계를 제거하고 소스 코드를 직접 파싱하는 구조를 설계하라.

섹션별 상세

기존 JVM 기반 분석 도구인 Joern은 파일 변경 시마다 전체 프로젝트를 재파싱하며 83초의 지연 시간을 발생시켰다. 이는 JVM 웜업과 Scala 컴파일 과정이 포함된 복잡한 구조 때문이며, 분석을 위해 TSX를 JS로 변환하는 추가 단계가 필요했다. 또한 1GB 이상의 RAM 점유와 다수의 고립된 세션 디렉토리를 생성하는 운영상의 결함이 확인됐다.

ts-morph로 전환한 결과 4개의 신규 파일 인덱싱 시간이 83초에서 230ms로 약 360배 단축됐다. 374개 파일 전체에 대한 엣지 재구축 작업도 8초 이내에 완료되는 성능 향상을 보였다. TypeScript 컴파일러 API를 직접 활용함으로써 별도의 트랜스파일레이션 과정 없이 .ts 및 .tsx 파일을 직접 읽어 분석 효율을 극대화했다.

분석의 정확도 측면에서도 TypeScript 전용 도구가 범용 그래프 분석기보다 우수한 성능을 보였다. React 컴포넌트 내부에 중첩된 화살표 함수를 정확히 메서드 노드로 인식하고 호출 엣지를 생성하는 것이 가능해졌다. 특히 타입 체커를 통해 파일 간 호출 관계를 정확히 해결함으로써 기존의 불완전한 스텁 노드 문제를 해결했다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 로컬 도구, 데이터 소스 및 서비스와 표준화된 방식으로 상호작용할 수 있도록 Anthropic에서 공개한 개방형 프로토콜이다. 에이전트가 파일 시스템이나 데이터베이스에 직접 접근하여 정보를 가져오거나 작업을 수행할 수 있게 돕는다.
ts-morph: — TypeScript 컴파일러 API를 사용하기 쉽게 감싼 래퍼 라이브러리이다. 코드의 추상 구문 트리(AST)를 탐색하고 수정하며, 타입 정보를 추출하여 정적 분석 도구를 구축하는 데 활용된다.
코드 속성 그래프(Code Property Graph): — 프로그램의 추상 구문 트리, 제어 흐름 그래프, 데이터 흐름 그래프를 하나의 그래프 구조로 통합한 데이터 모델이다. 복잡한 코드 베이스 내에서 심볼 검색, 호출 그래프 분석 및 영향도 평가를 수행하는 데 사용된다.
트랜스파일레이션(Transpilation): — 한 프로그래밍 언어로 작성된 소스 코드를 비슷한 수준의 추상화를 가진 다른 언어로 변환하는 과정이다. 본문에서는 TSX 파일을 분석하기 전 일반 JS로 변환하는 단계를 의미하며, 분석 효율을 떨어뜨리는 요인으로 지목됐다.

언급된 도구

ts-morph추천

TypeScript AST 탐색 및 분석

Joern비추천

코드 프로퍼티 그래프 분석

ArangoDB중립

그래프 데이터 저장소

언급된 리소스

GitHubcode-intel-mcp GitHub Repository