#Backend

이 서비스만 고치면 되겠지? AI가 놓치는 숨은 의존성을 추적하는 법

Summary

우리 AI가 달라졌어요: MSA의 복잡한 의존성, 그래프 RAG로 꿰뚫어보기

단일 레포에 갇힌 AI의 시야를 전체 시스템으로 확장하여 숨겨진 장애 지뢰밭을 제거하는 기술적 해법

마이크로서비스 환경에서 AI 코딩 도구가 직면한 '전체 시스템 맥락 부재' 문제를 해결하기 위해 그래프 데이터베이스(Neo4j)와 MCP를 활용한 지식 그래프 시스템 구축기를 다룹니다. 코드 분석 결과에 도메인 전문가의 지식을 입혀 AI가 시스템 간의 실시간 영향도를 파악할 수 있도록 설계한 과정을 공유합니다.

01벡터 검색의 한계를 극복한 그래프 DB 기반의 다단계(Multi-hop) 의존성 추적 구현
02Java, Go, TypeScript 등 다국어 환경의 코드를 파싱하여 API 및 DB 스키마 자동 추출
03MCP(Model Context Protocol)를 통해 Claude Code 등 AI 도구가 실시간으로 아키텍처 정보를 조회
04Git 기반 SSOT 전략으로 그래프 데이터의 변경 이력 관리와 전문가 편집 편의성 동시 확보
05실제 장애 위험이 높았던 UserChat 필드 추가 사례에서 58개 API의 파급 효과를 수 초 내에 분석

RECOMMENDATION

MSA 환경에서 AI 도구의 정확성을 높이고 싶은 아키텍트나, 복잡한 서비스 간 영향도 분석 자동화를 고민하는 백엔드 개발자에게 실질적인 가이드를 제공합니다.

The Problem

MSA 환경에서 AI 코딩 도구는 단일 레포지토리의 코드만 볼 수 있어, 서비스 간에 얽힌 복잡한 의존성이나 다단계 호출 체인(Multi-hop)을 인지하지 못하고 잘못된 코드를 제안하거나 장애를 유발할 위험이 있음.

The Solution

코드 정적 분석을 통한 구조 추출(Layer 1), Neo4j 그래프 DB와 도메인 지식을 결합한 지식 저장소(Layer 2), AI 도구가 이를 조회할 수 있는 MCP 서버(Layer 3)로 구성된 'Channel Knowledge' 시스템을 구축함.

The Result

직접 의존성뿐 아니라 3단계 이상의 간접 호출 경로까지 추적하여, 단일 서비스 수정 시 영향받는 58개의 API와 관련 워크플로우를 사전에 정확히 파악하고 안전한 변경 계획을 수립할 수 있게 됨.

Trade-off

정적 분석은 코드의 구조적 파악에만 그치므로 비즈니스 의미 부여를 위한 전문가의 수동 검수 과정이 필수적이며, 그래프 DB의 관리 난이도를 해결하기 위해 Git 기반의 별도 동기화 체계(SSOT)가 요구됨.

Key Concepts

Concept · 01

Graph RAG

지식 간의 관계를 그래프 구조로 연결하여 검색하고 AI에게 맥락을 제공하는 기술입니다. 단순 문서 기반 검색보다 복잡한 엔티티 간의 관계나 호출 경로를 추적하는 데 탁월합니다.

벡터 유사도 검색이 놓치기 쉬운 다단계 서비스 의존성 탐색에 활용
Neo4j 그래프 DB를 사용하여 서비스, API, 테이블 간의 연결성 정의

Concept · 02

MCP (Model Context Protocol)

AI 모델이 외부 데이터 소스나 도구에 접근할 수 있도록 하는 표준화된 통신 프로토콜입니다. 로컬이나 서버의 데이터를 AI 도구가 직접 조회하고 활용할 수 있는 통로 역할을 합니다.

AI 코딩 도구가 Neo4j 지식 그래프를 직접 조회할 수 있는 쿼리 인터페이스로 활용
20여 개의 전용 도구를 개발하여 도메인 엔티티 및 영향도 분석 결과 제공

Concept · 03

멀티홉(Multi-hop) 추적

직접적인 관계(1단계)를 넘어 여러 단계를 거쳐 연결된 간접적인 관계를 추적하는 방식입니다. MSA에서 하나의 API가 다른 API를 호출하고, 그것이 또 다른 서비스를 호출하는 복잡한 체인을 파악하는 데 필수적입니다.

Neo4j의 가변 길이 경로 패턴(Variable-length Path)을 사용하여 1~3단계 호출 체인 분석
REST API뿐만 아니라 RPC 및 Native Function 호출 관계까지 통합 추적

Continue reading · same source

More from 채널 톡

View all posts from 채널 톡

이 서비스만 고치면 되겠지? AI가 놓치는 숨은 의존성을 추적하는 법

Summary