MCP 출력 압축: Claude Code용 컨텍스트 모드 서버

컨텍스트 모드의 기능

컨텍스트 모드는 Claude Code에서 모든 MCP 도구 호출 시 원시 데이터가 200K 컨텍스트 창에 덤프되는 문제를 해결합니다. 소스의 예시에 따르면 Playwright 스냅샷은 56KB, GitHub 이슈 20개는 59KB, 액세스 로그 하나는 45KB가 소요됩니다. 30분 후에는 컨텍스트의 40%가 사라질 수 있습니다.

이 MCP 서버는 Claude Code와 이러한 출력 사이에 위치하여 샌드박스에서 처리하므로 모델에는 요약만 전달됩니다. 컨텍스트 사용량을 98% 감소시킵니다(315KB가 5.4KB로).

설치 및 설정

단일 명령어 설치:

/plugin marketplace add mksglu/claude-context-mode
/plugin install context-mode@claude-context-mode

또는 CLI를 통해:

claude mcp add context-mode -- npx -y context-mode

설치에는 대용량 출력을 컨텍스트 모드를 통해 자동으로 라우팅하는 자동 라우팅 스킬과, 서브에이전트 프롬프트에 컨텍스트 모드 라우팅을 주입하는 PreToolUse 훅이 포함됩니다. 별도의 프롬프팅이 필요하지 않습니다.

사용 가능한 도구

batch_execute: 여러 명령 실행 + 여러 쿼리 검색을 한 번의 호출로 수행(986KB → 62KB)
execute: 10개 언어로 코드 실행. stdout만 컨텍스트에 포함(56KB → 299B)
execute_file: 샌드박스에서 파일 처리. 원본 콘텐츠는 절대 외부로 유출되지 않음(45KB → 155B)
index: 마크다운을 FTS5로 청킹하여 BM25 순위 매기기(60KB → 40B)
search: 인덱싱된 콘텐츠를 여러 쿼리로 한 번에 검색(주문형 검색)
fetch_and_index: URL 가져오기, 마크다운 변환, 인덱싱(60KB → 40B)
stats: 도구별 분석이 포함된 세션 토큰 추적

기술적 구현

각 execute 호출은 고유한 프로세스 경계를 가진 격리된 서브프로세스를 생성합니다. 스크립트는 서로의 메모리나 상태에 접근할 수 없습니다. 서브프로세스는 코드를 실행하고 stdout을 캡처하며, 그 stdout만 대화 컨텍스트에 포함됩니다. 로그 파일, API 응답, 스냅샷과 같은 원시 데이터는 샌드박스를 벗어나지 않습니다.

10개 언어 런타임 사용 가능: JavaScript, TypeScript, Python, Shell, Ruby, Go, Rust, PHP, Perl, R. Bun은 자동 감지되어 JS/TS 실행 속도를 3-5배 향상시킵니다.

인증된 CLI는 자격 증명 전달을 통해 작동합니다 — gh, aws, gcloud, kubectl, docker는 환경 변수와 구성 경로를 상속받지만 대화에 노출되지 않습니다.

출력이 5KB를 초과하고 의도가 제공되면, 컨텍스트 모드는 의도 기반 필터링으로 전환됩니다: 전체 출력을 지식 베이스에 인덱싱하고, 의도와 일치하는 섹션을 검색하며, 관련 일치 항목만 반환하고 후속 쿼리를 위한 검색 가능한 용어 사전을 제공합니다.

지식 베이스는 SQLite FTS5(전문 검색 5) 가상 테이블을 사용합니다. index 도구는 코드 블록을 유지하면서 마크다운 콘텐츠를 제목별로 청킹한 후 저장합니다. 검색은 BM25 순위 매기기를 사용합니다 — 용어 빈도, 역문서 빈도, 문서 길이를 기반으로 문서에 점수를 매기는 확률적 관련성 알고리즘입니다.

📖 전체 소스 읽기: HN AI Agents