Token 98% 절감과 MCP 서버 최적화를 통한 에이전트 효율 극대화

Context

MCP spec의 도구 명명 규칙 위반으로 인한 유효성 검사 경고 발생. 다수의 도구 호출 시 발생하는 반복적인 스키마 전송으로 인한 과도한 Token 소모. 서버 시작 시 무조건적인 Chromium 인스턴스 실행에 따른 메모리 낭비.

Technical Solution

• MCP spec 준수를 위해 기존 콜론(:) 구분자를 언더스코어(_)로 변경하는 전면적인 리네이밍 수행
• 개별 필드 입력 방식에서 배열 기반의 단일 호출 방식으로 전환한 charlotte_fill_form 도입
• 서버 구동 시점이 아닌 첫 번째 도구 호출 시점에 브라우저를 실행하는 Lazy Initialization 구조 적용
• new Function 기반의 실행 방식에서 CDP Runtime.evaluate로 전환하여 ASI(Automatic Semicolon Insertion) 버그 해결
• Node.js 22 의존성을 제거하고 LTS 버전인 Node.js 20 이상으로 런타임 요구사항 완화
• character_delay 파라미터를 추가하여 실제 키보드 입력 이벤트와 유사한 Slow Typing 기능 구현

Impact

• 10개 필드 입력 시 Tool Definition 오버헤드 Token을 40,000개에서 4,000개로 90% 절감
• 50페이지 폼 검증 시 도구 호출 횟수를 500회에서 50회로 10배 감소

Key Takeaway

사용자 규모가 작을 때 Breaking Change를 빠르게 적용하는 것이 장기적인 유지보수 비용을 낮추는 전략적 선택임. 코드 내 반복되는 패턴의 버그 발견 시 단순 수정에 그치지 않고 전체 코드베이스에서 해당 패턴을 검색하여 근본적으로 제거해야 함.