SDL-MCP 공개: 코드 에이전트용 컨텍스트 예산 레이어로 토큰 비용 대폭 절감

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

TL;DR

작성자는 AI 코딩 에이전트가 전체 파일을 읽어 컨텍스트가 오염되고 토큰 비용이 급증하는 문제를 해결하기 위해 SDL-MCP를 설계했다. 이 시스템은 저장소를 심볼 그래프로 매핑하고 Iris Gate의 proof-of-need 사다리와 심볼 카드를 통해 필요한 코드 조각만 정책적으로 선별해 전달하므로 파일 읽기 대비 10–50배 토큰 절감 효과를 보고한다. 구현은 MCP 서버 패턴을 사용해 저비용 모델에 작업을 위임하고 상위 모델이 검증하는 루프를 도입했으며 live indexing, 샌드박스 실행, compact tool gateway 같은 구성요소를 포함한다. 모델별 작동 차이와 일부 모델이 문서 지침을 무시하는 한계가 존재하지만, 토큰·비용 관리와 컨텍스트 품질 개선이라는 실무적 목표에는 유효한 접근으로 제시된다.

실용적 조언

저비용 모델에 반복적·단순 작업을 위임하고 상위 모델로 검증 루프를 구성하면 토큰 비용을 관리하면서 품질 보증이 가능하다.
심볼 수준 인덱싱과 필요 기반 증강(retrieval-on-need) 전략을 도입하면 전체 파일 읽기 대신 관련 심볼만 제공해 토큰 사용량을 크게 줄일 수 있다.
라이브 인덱싱을 구축해 파일 수정 시 임베딩을 즉시 갱신하면 검색 결과의 신선도를 유지하고 문서 드리프트를 줄일 수 있다.

섹션별 상세

작성자는 AI 코딩 에이전트가 전체 파일을 읽어 컨텍스트가 빠르게 오염되고 토큰 사용량이 급증하는 문제를 해결하려고 했다고 밝혔다. 이 문제를 해결하기 위해 저장소를 심볼 그래프로 매핑하고 에이전트가 실제로 필요로 하는 심볼 단위 컨텍스트만 정책 기반으로 선택·전달하는 접근을 택했다. 글에는 Iris Gate의 proof-of-need 사다리로 파일 읽기 대비 10–50배 토큰 절감이 가능하다는 주장과 함께 심볼 카드와 스켈레톤, 핫패스 우선 제공 같은 구체적 메커니즘이 나열되어 있다. 이 접근은 단순히 더 많은 정보를 주는 것이 아니라 더 정제된, 시점에 맞는 소량의 컨텍스트를 제공함으로써 비용과 효율을 동시에 개선하려는 의도를 명확히 보여준다.

프로젝트는 심볼 카드, 작업 형태에 맞춘 그래프 슬라이스, 의미 기반의 diff와 blast-radius 분석, 실시간 인덱싱, 샌드박스 실행과 제어된 출력 획득 같은 여러 구성요소로 설계되었다. 심볼 카드와 핫패스는 전체 원시 소스 대신 요약된 심볼 정보를 먼저 제공하고 필요 시에만 원본을 유입시키는 식으로 입력→처리→출력 경로를 설계한다. 실시간 인덱싱은 수정이 발생하면 임베딩을 벡터 DB로 즉시 푸시해 검색 후보의 신선도를 유지하며 샌드박스 실행은 실행 결과가 채팅 컨텍스트를 오염시키지 않도록 출력량을 제어하는 역할을 한다. 이러한 구성은 디버깅·리뷰·설명·구현 같은 다양한 작업 유형에 맞춰 컨텍스트를 맞춤 제공하는 엔지니어링 관점의 설계 원리를 제시한다.

작성자는 개발 초기 단계에서 MCP 서버 패턴을 활용해 고비용 모델이 저비용 모델에 작업을 위임하고 상위 모델이 검증하는 루프를 만들었다고 보고했다. 구체적으로는 초기 계획과 PRD 작성에 고성능 모델을 사용하고, 단순 구현·검증에는 비교적 저렴한 모델을 활용하는 방식으로 토큰·요금 관리를 시도했다. 글에 따르면 Claude로 기획·검증을 진행했고 이후 Codex로 전환해 대부분의 코딩을 수행했으며 작성자는 Claude code가 약 33%의 코딩 작업을 담당했다고 밝혔다. 이 워크플로는 비용 대비 효율을 맞추기 위해 모델 역할을 분리하고 검증 루프를 통해 품질을 확보하는 실용적 전략을 보여준다.

성능 관련 근거와 한계도 본문에 포함되어 있다. 작성자는 SDL-MCP를 도입했을 때와 도입하지 않았을 때의 사용량 차이를 체감했으며, Iris Gate 기반의 proof-of-need 단계와 심볼 우선 전략으로 토큰 비용 감소를 경험했다고 보고했다. 반면 일부 모델(예: Opus 4.8)은 문서 지침을 무시해 컨텍스트 제어가 잘 되지 않았고, GLM5.1·Gemini code 같은 조합은 단순 작업에서만 유효했다고 기술해 제약 조건을 명시했다. 따라서 이 시스템은 컨텍스트 절감에 유효하지만 모델별 행동 차이와 일부 워크로드에서의 한계가 있다는 현실적 제약을 동반한다.

프로덕션 및 사용성 측면에서 SDL-MCP는 stdio, 스트리밍 HTTP 서버, CLI 등 여러 실행 모드를 제공하며 토큰 절감 효과를 모니터링하는 통계 기능도 포함되어 있다. 저장소의 변경을 벡터 DB로 즉시 반영하는 라이브 인덱싱은 개발 중 발생하는 문서·코드 드리프트를 줄이고 검색 결과의 신선도를 유지하는 데 기여한다. 또한 도구 정의를 컨텍스트에서 격리하는 compact tool gateway와 샌드박스 실행은 에이전트의 불필요한 도구 로딩이나 출력 오염을 방지하는 방식으로 구현되어 있다. 이러한 인터페이스 설계는 에이전트 통합을 현실적으로 용이하게 하고 운영 중 비용·품질 관리를 돕는 실무적 이점을 제공한다.

용어 해설

심볼 그래프(Symbol Graph): — 소스코드의 함수·클래스·심볼 간 관계를 노드와 엣지로 표현한 그래프이며, 코드 검색과 의존성 추적을 위해 심볼 수준의 연결성 정보를 빠르게 조회할 수 있게 만든다. 입력으로는 파싱된 심볼 메타데이터와 참조 정보가 들어가고 처리 단계에서 그래프 탐색·슬라이싱을 통해 관련 코드 조각을 선택하며 출력으로는 에이전트가 요구하는 최소한의 코드 컨텍스트 조각이 제공된다. 리포지토리 전체를 파일 단위로 읽는 대신 관련 심볼만 제공함으로써 토큰 사용량을 획기적으로 줄이는 핵심 구조로 사용된다.
MCP 서버(MCP): — 보다 비싼 모델이 전체 작업을 수행하지 않도록 중간에 저비용 모델을 배치해 작업을 분담하고 검증 루프를 통해 결과를 확인하는 서버 아키텍처로 정의된다. 입력으로 고비용 요청이 들어오면 MCP는 해당 작업을 저비용 모델에 위임하고 처리된 출력을 상위 모델이 검증하거나 보완하는 방식으로 처리량과 비용을 관리한다. 이 구조는 에이전트 워크플로에서 토큰·요금 절감과 검증 가능성을 동시에 확보하는 목적으로 활용된다.
벡터 데이터베이스(Vector DB): — 문서나 코드 청크의 임베딩을 저장하고 유사도 검색을 수행하는 저장소로, 입력 임베딩에 대해 가장 관련성 높은 항목을 빠르게 조회해 검색 증강 워크플로우의 기반이 된다. 실시간 색인(push indexing)을 지원하면 파일 변경 시 임베딩을 즉시 갱신해 검색 결과의 신선도를 유지할 수 있으며, 이 프로젝트는 편집을 라이브로 푸시해 저장소와 동기화하는 방식을 사용했다. 벡터 DB는 검색 후보 선별을 담당하고 이후 cross-encoder 재순위화나 정책 기반 필터링과 결합되어 최종 컨텍스트를 결정한다.

언급된 도구

Claude중립

기획·검증 및 일부 코딩 작업에 사용된 고성능 LLM

Codex추천

주요 코딩 작업을 수행한 모델

GLM5.1중립

검토 루프에 간헐적으로 투입된 모델

Gemini code중립

단순 작업에서 검토 대상으로 사용된 모델

언급된 리소스

GitHubSDL-MCP repository