ast-outline v0.2.0 출시: MCP 지원으로 Claude Code의 토큰 비용 90% 절감

실용적 조언

brew install aeroxy/ast-outline/ast-outline 명령어로 설치 후 MCP 서버로 등록하여 사용 가능하다
에이전트가 파일 전체를 읽기 전에 outline 도구를 먼저 호출하도록 프롬프트를 구성하면 비용을 절감할 수 있다

섹션별 상세

ast-outline은 소스 파일에서 클래스, 시그니처, 필드, 주석 등 구조적 정보만 추출하고 메서드 본문은 제거한다. 입력 파일의 전체 내용을 읽는 대신 구조적 뼈대만 LLM에 전달하여 처리량을 줄이는 방식이다. 이를 통해 기존 대비 5~10배의 토큰 절감 효과와 더불어 코드베이스 탐색 속도를 비약적으로 향상시켰다. 에이전트는 구조 파악 후 필요한 특정 라인 범위만 선택적으로 읽어 효율적인 작업이 가능하다.

v0.2.0 업데이트를 통해 Model Context Protocol(MCP) 서버 기능이 공식적으로 도입됐다. stdio 기반의 MCP 서버로 실행되어 MCP를 지원하는 모든 에디터나 에이전트에서 outline, digest, show, implements 기능을 네이티브 도구로 직접 호출할 수 있다. 별도의 셸 파싱이나 클라이언트 측의 복잡한 JSON 처리가 필요 없어져 개발 도구와의 통합 편의성이 극대화됐다.

json

{
  "mcpServers": {
    "ast-outline": {
      "command": "ast-outline",
      "args": ["mcp"]
    }
  }
}

MCP 서버 설정을 통해 ast-outline을 에이전트 도구로 등록하는 예시

MCP Inspector 인터페이스에서 ast-outline 서버를 설정하고 연결하는 화면 — Screenshotast-outline MCP 서버를 로컬에서 테스트하고 도구 호출을 검증할 수 있는 MCP Inspector 실행 모습을 보여준다. 사용자가 command와 arguments를 입력하여 에이전트 도구가 정상적으로 작동하는지 확인하는 과정을 시각화했다.

성능과 호환성 측면에서 최적화된 설계를 적용했다. MCP 서버는 완전 동기식으로 작동하며 추가적인 외부 의존성 없이 구현되어 실행 파일 크기 증가를 600KB 수준으로 억제했다. 기존 CLI의 JSON 출력 모드와 동일한 버전 관리 스키마를 공유하므로 기존에 구축된 툴링을 수정 없이 그대로 사용할 수 있다는 점이 확인됐다.

용어 해설

추상 구문 트리 개요(AST Outline): — 소스 코드의 구조적 형태인 추상 구문 트리(AST)를 분석하여 클래스, 메서드 시그니처, 필드 등의 메타데이터만 추출하는 기법이다. 메서드 본문과 같은 세부 구현을 제외하고 구조적 뼈대만 제공함으로써 LLM이 코드베이스의 전체 지형을 빠르게 파악하도록 돕는다.
모델 컨텍스트 프로토콜(Model Context Protocol): — AI 모델이 외부 도구나 데이터 소스와 통신하기 위한 개방형 표준 프로토콜이다. 서버-클라이언트 구조를 통해 에이전트가 로컬 파일 시스템이나 데이터베이스의 정보를 일관된 방식으로 호출하고 활용할 수 있게 지원한다.
컨텍스트 윈도우(Context Window): — LLM이 한 번의 추론 과정에서 동시에 처리하고 기억할 수 있는 텍스트 데이터의 최대 범위를 의미한다. 이 범위가 제한적이기 때문에 불필요한 코드 본문을 제거하고 구조 정보만 전달하는 방식은 토큰 효율성을 극대화하는 핵심 전략이 된다.

언급된 도구

ast-outline추천링크

코드 구조 추출 및 MCP 서버 제공

Claude Code중립

코딩 에이전트

언급된 리소스

GitHubast-outline v0.2.0 Release Notes