🗜️MCP

Context Mode - Claude Code의 컨텍스트 사용량을 98% 줄이는 MCP 서버

AI 에이전트의 컨텍스트 윈도우를 효율적으로 관리하여 30분 세션을 3시간으로 연장하는 혁신적인 솔루션

↗ 원본 링크

#Claude#MCP#컨텍스트관리#AI에이전트

무엇인가요?

Context Mode는 Claude Code가 외부 도구를 사용할 때 발생하는 컨텍스트 낭비 문제를 해결하는 MCP 서버입니다. 315KB의 데이터를 5.4KB로 압축하여 98%의 컨텍스트를 절약합니다.

왜 필요한가요?

기존 문제점

▸Claude Code는 도구 호출마다 원시 데이터를 컨텍스트에 직접 저장

▸Playwright 스냅샷(56KB), GitHub 이슈(59KB) 등이 빠르게 쌓임

▸30분 사용 시 200K 컨텍스트의 40%가 소모

▸81개 도구 활성화 시 첫 메시지 전에 이미 72% 사용

핵심 기능

1. 데이터 압축 및 필터링

▸Claude Code와 도구 출력 사이에서 중간 계층 역할

▸실제 압축 사례:

- Playwright 스냅샷: 56KB → 299B

- GitHub 이슈 20개: 59KB → 1.1KB

- CSV 500행: 85KB → 222B

- Git 로그 153개: 11.6KB → 107B

2. 샌드박스 실행 환경

▸각 실행을 격리된 서브프로세스에서 처리

▸stdout만 컨텍스트에 포함

▸로그, API 응답, 스냅샷은 샌드박스 내부에만 유지

▸10개 언어 지원: JavaScript, TypeScript, Python, Shell, Ruby, Go, Rust, PHP, Perl, R

3. 지능형 지식베이스

▸

SQLite FTS5: 기반 전문 검색

▸마크다운을 헤딩 단위로 분할하여 인덱싱

▸

BM25 랭킹 알고리듬: 으로 정확한 관련성 계산

▸Porter stemming으로 어근 기반 검색

▸요약이 아닌 **정확한 코드 블록** 반환

성능 개선

컨텍스트 효율

▸세션 지속 시간: **30분 → 3시간**

▸45분 후 남은 컨텍스트: 60% → 99%

▸전체 출력: 315KB → 5.4KB

실제 시나리오

11개 실제 작업(테스트 분석, 오류 진단, git diff 검토 등)에서 모두 출력 1KB 이하 유지

사용 방법

설치

▸Claude Code의 **Plugin Marketplace**에서 자동 설치

▸MCP 전용 설치도 가능

주요 도구

bash

# 코드 실행
execute --language python --code "print('Hello')"

# 지식베이스 인덱싱
index --content "마크다운 문서"

# 검색
search --query "검색어"

# URL 가져와서 인덱싱
fetch_and_index --url "https://example.com"

누가 사용하면 좋을까요?

▸Claude Code를 장시간 사용하는 개발자

▸대량의 데이터를 처리하는 AI 에이전트 운영자

▸컨텍스트 한도에 자주 도달하는 사용자

▸효율적인 AI 워크플로우를 구축하려는 팀

핵심 장점

✅ 98% 컨텍스트 절약 - 같은 한도로 6배 더 오래 작업

✅ 격리된 실행 - 안전하고 깔끔한 출력

✅ 지능형 검색 - 정확한 코드 블록 검색

✅ 다국어 지원 - 10개 언어 런타임

✅ 쉬운 설치 - Plugin Marketplace 원클릭 설치