로그 감소기 MCP 서버, 클로드 코드가 로그를 읽을 때 토큰 사용량 절감

Log Reducer는 Claude Code를 위해 특별히 제작된 MCP 서버로, 로그 파일을 서버 측에서 읽고 대화에 축소된 출력만 전송하여 원시 로그가 컨텍스트 창에 들어가는 것을 방지합니다. 개발자에 따르면 2,000줄의 로그는 세션에서 영구적으로 20,000개 이상의 토큰이 제거되는 것을 의미합니다.

압축 변환

이 도구는 API 호출 없이 로그를 50-90% 압축하기 위해 19가지 결정론적 변환을 실행합니다:

• 스택 트레이스 접기 — 프레임워크 노이즈를 축소하면서 코드 프레임 유지
• 반복 및 거의 동일한 줄 중복 제거
• 헬스 체크, 하트비트, 진행률 표시줄, Docker 보일러플레이트를 포함한 노이즈 필터링
• UUID, 타임스탬프, 긴 URL 단축
• 사이클 감지 및 반복되는 다중 라인 블록 축소
• 액세스 로그 압축 — 보일러플레이트를 메서드 + 경로 + 상태로 제거

Claude Code로 개발

전체 프로젝트는 Claude Code를 사용하여 구축되었습니다. 개발자는 로그 샘플을 대화에 붙여넣으면, Claude가 압축 가능한 부분을 분석하고 변환을 구현하며 테스트 픽스처에 대해 검증했습니다. 저장소의 평가 워크플로우 — 로그 붙여넣기, 이상적인 출력 자동 생성, 파이프라인과 차이 비교, 수정 사항 구현 — 는 전적으로 Claude Code로 구동되도록 설계되었습니다.

설정 및 사용법

npm install -g logreducer로 설치하고 .claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "logreducer": {
      "command": "npx",
      "args": ["-y", "logreducer", "--mcp"]
    }
  }
}

사용법: 로그를 클립보드에 복사하고 Claude Code에서 /logdump를 입력하세요. 원시 로그는 임시 파일에 저장되고 서버 측에서 자동으로 축소됩니다. 파일을 직접 가리키거나, 로그 수준별 필터링, 정규식으로 grep, 대규모 로그의 구조적 요약을 얻을 수도 있습니다.

이 도구는 MIT 라이선스 하에 무료 오픈 소스로 제공되며, GitHub의 launch-it-labs/log-reducer와 npm의 logreducer에서 이용 가능합니다.