AST를 활용하여 agents.md 생성을 자동화하는 MCP 서버 공개

실용적 조언

에이전트의 컨텍스트 오염을 방지하기 위해 agents.md 파일을 자동화 도구로 관리할 것을 권장한다

섹션별 상세

agents.md 파일이 시간이 지남에 따라 실제 코드와 괴리가 생기는 문제를 해결하기 위해 AST 분석 기법을 도입했다. 소스 코드를 구문 트리로 변환하여 핵심 로직과 구조를 추출함으로써, 에이전트가 모든 파일을 일일이 읽지 않고도 프로젝트의 전체 맥락을 파악할 수 있는 요약본을 생성한다. 이는 에이전트가 제한된 컨텍스트 윈도우 내에서 가장 중요한 정보에 집중할 수 있도록 돕는 역할을 한다.

대규모 코드베이스에서의 성능 저하를 방지하기 위해 지능형 캐싱 시스템을 구축했다. 첫 분석 이후에는 변경된 파일만 선별적으로 추적하여 업데이트를 수행하며, 이를 통해 30만 라인이 넘는 대형 프로젝트에서도 지연 없는 분석 결과를 도출했다. 특정 기준에 따라 변경 사항을 감지하는 로직을 통해 불필요한 재분석 과정을 제거하여 전체적인 시스템 부하를 최소화했다.

특정 변경 기준에 따라 자동으로 요약을 갱신하는 워크플로우를 제공하여 에이전트의 컨텍스트 정확도를 유지한다. 이는 에이전트가 낡은 정보를 바탕으로 잘못된 코드를 생성하는 오류를 방지하고, 추론 시 사용하는 토큰의 효율성을 극대화하는 효과가 있다. 현재 오픈 소스로 공개되어 있으며 커뮤니티의 피드백을 통해 지속적인 기능 개선을 목표로 하고 있다.

이미지 분석

Screenshot
공개된 MCP 서버의 프로젝트 명칭과 'agents-md를 효율적으로 생성하는 MCP 서버'라는 핵심 목적을 명시하고 있다. 개발자의 프로필과 프로젝트의 오픈 소스 상태를 시각적으로 확인시켜 준다.
nushey/agents-md-generator GitHub 저장소의 미리보기 이미지이다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Anthropic이 발표한 개방형 표준으로, AI 에이전트가 로컬 데이터나 외부 도구와 안전하고 쉽게 연결될 수 있도록 하는 통신 규약이다. 이를 통해 에이전트는 복잡한 설정 없이도 코드베이스나 데이터베이스에 접근할 수 있다.
추상 구문 트리(AST): — 프로그래밍 언어로 작성된 소스 코드의 구조를 트리 형태로 표현한 것이다. 단순 텍스트 분석보다 정확하게 코드의 함수, 클래스, 변수 간 관계를 파악할 수 있어 효율적인 코드 요약에 활용된다.
에이전트 컨텍스트 파일(agents.md): — AI 에이전트가 프로젝트의 목적, 구조, 기술 스택을 빠르게 이해할 수 있도록 작성된 가이드 파일이다. 에이전트가 불필요한 파일을 읽는 과정을 줄여 토큰 효율을 높이는 데 기여한다.

언급된 도구

agents-md-generator추천링크

AST 분석을 통한 agents.md 파일 자동 생성 및 캐싱 기반 업데이트

언급된 리소스

GitHubnushey/agents-md-generator GitHub