log-context-mcp: MCP 도구가 Claude 디버깅을 위한 로그 토큰 사용량을 96% 감소시킵니다

log-context-mcp는 디버깅 세션 중 Claude Code가 장황한 로그 파일에 토큰을 낭비하는 문제를 해결하기 위해 구축된 MCP(Model Context Protocol) 도구입니다. 상태 점검 및 INFO 스팸에 15k 토큰을 소모할 수 있는 원시 로그 파일을 붙여넣는 대신, 이 도구는 로그가 Claude의 컨텍스트에 도달하기 전에 전처리합니다.

작동 방식

이 도구는 로그 파일에 대해 여러 전처리 단계를 수행합니다:

• 중복 줄 제거
• 스택 트레이스 그룹화
• 노이즈 제거
• 전체 로그 덤프 대신 약 1000 토큰 요약 생성

성능 및 테스트

2000줄의 Apache 로그 테스트에서 근본 원인을 여전히 정확히 식별하면서 96.5% 토큰 감소 효과를 보였습니다. 개발자는 Claude가 실제로 중요한 3줄을 찾기 전에 로그 파일에 15k 토큰을 낭비하는 문제를 반복적으로 마주친 후 이 도구를 구축했습니다.

추가 기능

이 도구는 압축된 출력에 저렴한 모델(Gemma/Haiku/Ollama)을 실행하여 근본 원인 분석 및 오류 타임라인을 제공하는 선택적 의미 계층을 포함합니다. 별도의 API 키를 원하지 않는 사용자를 위해, 기존 Claude 구독을 통해 Haiku 하위 에이전트를 사용하는 /analyze-log 스킬도 있습니다.

관련 도구 및 개발 상태

개발자는 이 로그 특화 솔루션을 구축한 후 일반 목적 CLI 출력 압축을 위한 유사 도구인 rtk를 발견했습니다. log-context-mcp는 상위 의미 분석 계층과 함께 로그에 더 특화되어 있습니다.

이 도구는 아직 초기 개발 단계이며, MCP 마켓플레이스에 제출하여 더 쉽게 발견되도록 하고 더 많은 로그 형식 지원을 추가할 계획입니다. MIT 라이선스로 출시되었으며 GitHub에서 설정 지침을 확인할 수 있습니다.

개발자는 사용자가 어떤 로그 형식 및 스택을 테스트하기 원하는지 피드백을 구하고 있습니다.