mksglu/context-mode
TypeScript0 / 0
AI coding agent의 도구 출력과 세션 기록을 압축·검색하는 MCP server
TL;DR
Context Mode는 TypeScript 기반 MCP server이자 여러 AI coding agent에 붙이는 plugin-extension 도구입니다. 도구 출력을 sandbox에서 처리해 원시 데이터를 컨텍스트에 넣지 않고, ctx_execute 같은 도구로 필요한 결과만 반환하며 README는 315 KB를 5.4 KB로 줄인 사례와 98% 절감 수치를 제시합니다. SQLite·FTS5·BM25를 이용해 세션 이벤트를 저장하고 compact 이후 관련 상태만 복원하므로 장시간 작업의 세션 연속성도 보강합니다. 다만 플랫폼마다 plugin·hooks·routing 파일의 지원 수준이 다르고, hooks가 없는 환경에서는 모델의 지침 준수에 의존하므로 사용 중인 에이전트의 설치 방식과 Node.js 요구사항을 먼저 확인해야 합니다.
핵심 포인트
- Context Mode는 TypeScript로 작성된 MCP server이자 AI coding agent용 plugin-extension 도구이며, Claude Code·Codex CLI·Cursor·OpenCode 등 17개 플랫폼에 연결됩니다. MCP와 hooks 또는 각 플랫폼의 plugin API를 조합해 도구 출력 라우팅과 세션 추적을 처리합니다. 여러 에이전트를 함께 운영한다면 플랫폼별 설정 차이를 한 패키지로 통합할 수 있습니다.
- 샌드박스 도구는 원시 출력을 대화 컨텍스트에 직접 넣지 않고 JavaScript 실행 결과나 검색 결과만 반환합니다. README의 예시는 315 KB 입력을 5.4 KB로 줄이고, 47번 Read 호출을 ctx_execute 한 번으로 대체해 100배의 컨텍스트 절감을 목표로 합니다. 대규모 저장소에서 파일을 직접 읽히기보다 코드로 집계할 때 효과가 큽니다.
- 세션 이벤트와 파일 수정·Git 작업·오류·사용자 결정을 SQLite에 저장하고 FTS5와 BM25 검색으로 필요한 기록만 복원합니다. 대화가 compact된 뒤에도 이전 상태를 전부 다시 주입하지 않으며, --continue를 사용하지 않으면 이전 세션 데이터가 즉시 삭제됩니다. 장시간 코딩 세션의 연속성이 중요할 때 핵심 기능이 됩니다.
- Claude Code에서는 marketplace plugin이 MCP 도구 11개와 여러 lifecycle hooks를 자동 등록하지만, Antigravity IDE와 Zed처럼 hooks가 없는 환경에서는 routing 파일의 지침 준수에 의존합니다. Node.js >= 22.5가 필요한 플랫폼이 많고, Cursor·Codex·OpenCode는 각각 hook 지원 범위와 설정 제약이 다릅니다. ELv2 라이선스와 플랫폼별 수동 설정을 도입 전에 확인해야 합니다.
벤치마크
| 벤치마크 | 지표 | 값 | 비교 |
|---|---|---|---|
| MCP tool output reduction | context size reduction | 98% | README가 제시한 sandbox 처리 수치이며, 모든 도구 호출과 환경에서 동일하게 재현되는 독립 평가 결과는 아닙니다. |
| Sandbox example | input size | 315 KB → 5.4 KB | README의 예시 수치이며 특정 도구 출력 처리 사례에 해당합니다. |
| Think in Code example | context reduction | 100x | README가 47회의 Read 호출과 1회의 ctx_execute를 비교해 제시한 목표 사례이며, 일반적인 성능 보장은 아닙니다. |
| Supported clients | platform count | 17 | README가 routing 지원 대상으로 명시한 클라이언트 수이며, 플랫폼별 hooks 수준은 서로 다릅니다. |
이미지 분석
21.4k
STARS
1.5k
FORKS
+652
TRENDING
0
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.
