Context Modeとは何か ツール出力を98%削減するAIエージェントのコンテキスト最適化MCP
GitHubで2万2000スター超・週間+2,102スターを獲得したmksglu/context-modeを解説する。ツール出力を隔離サブプロセスで処理してコンテキストウィンドウの消費を抑える仕組み、Claude Codeへのインストール手順、OpenViking・ECC・標準の/compactとの違いを整理する。
Context Modeとは何か
Context Mode（mksglu/context-mode）は、Claude CodeやCursorなどのAIコーディングエージェント向けに配布されているオープンソースのMCPサーバーである。Webページ・API応答・ログファイル・コード実行結果といったツール出力を隔離されたサブプロセス（サンドボックス）内で処理し、生データをコンテキストウィンドウに直接読み込ませず、要約・抜粋された結果だけを返すことで、開発元は「最大98%のトークン削減」をうたう。2026年9月時点、GitHubで2万2000スターを超え、週間で2,102スター増と急伸してトレンド入りした。
何が問題を解決するのか — コンテキストウィンドウの肥大化
AIコーディングエージェントは、Webページの取得結果・ログファイルの中身・大量のGitHub Issue・Playwrightのブラウザスナップショットなど、サイズの大きいツール出力をそのままコンテキストウィンドウに読み込みがちである。これが積み重なると、有効なコンテキスト長を圧迫し、早期のコンパクション（要約による履歴圧縮）や応答品質の劣化を招く。Context Modeの開発元はこの状態を「コンテキスト問題のもう半分」と位置づけ、ツール出力そのものを削る側からアプローチしている。
仕組み — 4つの構成要素
Context Modeは大きく4つの仕組みで構成される。第一に、ctx_execute・ctx_execute_fileといったMCPツールが隔離サブプロセス内でコードを実行し、標準出力だけがコンテキストへ戻る「サンドボックス実行」。第二に、ファイル編集・Git操作・エラー・ユーザーの判断をSQLite（FTS5全文検索付き）で記録し、コンテキストのコンパクションをまたいで状態を追跡する「セッションメモリ」。第三に、BM25ランキングで索引済みコンテンツから必要な部分だけをオンデマンドに取得する「ナレッジベース」。第四に、PreToolUse/PostToolUseフックが危険なコマンドを遮断しつつ、大容量になりそうなツール出力をサンドボックスへ自動的にルーティングする「フックによる強制」である。
提供されるMCPツールと対応言語
READMEによれば、Context Modeはctx_execute・ctx_execute_file・ctx_batch_execute・ctx_index・ctx_search・ctx_fetch_and_index・ctx_stats・ctx_doctor・ctx_upgrade・ctx_purge・ctx_insightの計11個のMCPツールを提供する。コード実行はJavaScript・TypeScript・Python・Shell・Ruby・Go・Rust・PHP・Perl・R・Elixir・C#の12言語ランタイムに対応する。
効果 — 開発元公表のベンチマーク
以下はREADME記載の値で、開発元による公表値である点に留意されたい。Playwrightスナップショットは56.2KBから299Bへ（約99%削減）、20件のGitHub Issueは58.9KBから1.1KBへ（約98%削減）、フルセッションは986KBから62KBへ（約94%削減）とされる。開発元はこれにより、コンパクションが発生するまでの実利用時間が約30分から約3時間に伸びると説明している。第三者による独立した再現ベンチマークは2026年9月時点で確認できておらず、削減率は利用するツールの種類やプロジェクトの内容によって変動しうる。
対応クライアント — 17プラットフォーム
READMEでは17クライアントへの対応を掲げており、Claude Code（プラグインマーケットプレイス経由）・Gemini CLI・VS Code Copilot・JetBrains Copilot・GitHub Copilot CLI・Cursor・OpenCode・KiloCode・OpenClaw・Codex CLI・Antigravity IDE・Antigravity CLI・Kiro・Zed・Pi Coding Agent・OMP（Oh My Pi）などが列挙されている。ただしフックによる強制の実効性はクライアントによって差があり、READMEはCursorがSessionStartフックを持たないためコンパクション復元が使えないこと、Antigravity IDEとZedはフック自体に対応しておらずルーティングの遵守率が約60%（フックあり構成では約98%）にとどまることを明記している。
インストール — Claude Codeの場合
Claude Codeでの推奨手順はプラグインマーケットプレイス経由のインストールである。それ以外のクライアントはグローバルnpmインストールが基本ルートで、クライアントごとにMCPサーバーの設定ファイルへのエントリ追加やフック設定が別途必要になる。
# Claude Code（推奨）
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode
# その他のプラットフォーム共通（グローバルインストール）
npm install -g context-mode動作要件
READMEによると、Linux環境ではNode.js 22.5以上（またはBun）、macOS/Windowsでは Node.js 20以上が必要とされる。CentOS 7/8やAlpineなど古めのLinuxディストリビューションでは、better-sqlite3のネイティブビルドにC++コンパイラを含むビルドツールが別途必要になる場合がある。
ライセンスと採用実績
Context ModeはElastic License 2.0（ELv2）で公開されている。ソースコードは公開され無料で利用・改変できるが、OSI承認の狭義のオープンソースライセンスとは異なり、マネージドサービスとして再パッケージ化し第三者に提供することなどが制限される「ソースアベイラブル」型のライセンスである点は導入前に確認したい。READMEはMicrosoft・Google・Meta・Amazon・IBM・NVIDIA・ByteDance・Stripe・Datadog・Salesforceなど大手企業名を「採用例」として挙げているが、これは主にElastic License 2.0という同一ライセンス形態の採用実績を示すものであり、Context Mode自体の導入実績を意味するものではない点に注意したい。Hacker Newsでは570ポイント超を獲得し1位にランクインした実績がある。料金は無料でアカウント登録不要、処理はすべてローカルで完結しクラウドへのテレメトリ送信はないとされる。
既存の手法・類似ツールとの違い
コンテキスト消費を抑える手法としては、Claude Code標準の/compactコマンドによる履歴要約、ByteDance系Volcano Engineが公開するOpenViking（コンテキストデータベース）のような外部メモリ・知識管理、affaan-m/ECCのようなエージェントハーネス最適化スイートが並存する。Context Modeの独自性は、ツール出力そのものが生成された時点でサンドボックス内に閉じ込め、要約結果のみをコンテキストへ返す「入口対策」に絞っている点にある。
| 手法 | アプローチ | 主な対象 | 導入形態 | セッション継続性 | ライセンス |
|---|---|---|---|---|---|
| Context Mode | ツール出力を隔離サブプロセスで処理し要約のみ返す | 大容量ツール出力（Web/ログ/実行結果） | MCPサーバー＋Hooks（17クライアント） | あり（SQLite+FTS5でコンパクション復元） | Elastic License 2.0（ソースアベイラブル） |
| 標準の/compact | 会話履歴全体をLLMで要約し圧縮 | 会話履歴全般 | エージェント組み込み機能 | 要約後は詳細が失われやすい | エージェント本体に準拠 |
| OpenViking | メモリ・知識・スキルをファイルシステム風に統一管理、階層的ロード | 長期記憶・ナレッジ検索 | 外部サーバー（MCP等で連携） | あり（viking://での永続化） | 本体AGPLv3／CLI等はApache 2.0 |
| ECC（affaan-m/ECC） | サブエージェント・スキル・コマンド群でハーネス全体を最適化 | 開発ワークフロー全般 | プラグイン・npmパッケージ・GitHub App | 運用ガイドライン中心（自動保存の仕組みは限定的） | リポジトリ記載を要確認 |
/compactは会話履歴全体を圧縮する事後対策であるのに対し、Context Modeはツール出力が生成された瞬間に隔離する事前対策であり、両者は排他的ではなく併用が前提となる。OpenVikingは長期的な記憶・知識・スキルの管理に主眼があり、Context Modeの即時的なツール出力削減とは役割が異なる。ECCはコンテキスト管理も含むがスコープがエージェントハーネス全体の運用最適化に及ぶ点で毛色が違う。
効果と限界
効果面では、ツール出力の削減幅がREADME公表値どおり大きければ、長時間セッションでのコンパクション頻度を下げ、複雑なタスクを1セッションで完結させやすくなる可能性がある。一方で限界も明確である。第一に、削減率はあくまで開発元公表のベンチマークであり、実プロジェクトの出力内容次第で変動する。第二に、フックによる強制の実効性はクライアント依存で、Cursor・Antigravity IDE・Zedなど一部クライアントでは恩恵が限定的になる。第三に、Elastic License 2.0はソースアベイラブルであり、再配布・SaaS化を検討する場合はライセンス条項の確認が必須である。第四に、ctx_execute_fileはデフォルトでプロジェクトルート内に実行を制限し、ネットワークフェッチはクラウドメタデータエンドポイント（169.254.169.254）や危険なURIスキームをデフォルトでブロックするとされるが、サンドボックスへのコード実行権限を与える以上、社内規定でのセキュリティレビューは別途必要になる。
実務での使いどころ
中小企業の受託開発文脈では、大規模な既存コードベースの調査・大量ログの解析・複数ページのWebスクレイピングを伴う要件整理など、ツール出力が肥大化しやすいタスクでAIコーディングエージェントを長時間使う場面が主な適用先になる。逆に短時間で完結する小規模タスクでは、導入・設定の手間に見合うメリットは小さい可能性がある。
関連記事
- 「i-have-adhd」と「ponytail」とは何か — GitHub急上昇の2大Agent Skillを徹底比較【2026年9月版】
- OpenVikingとは？AIエージェントの記憶・知識・スキルを統一管理するコンテキストDB
よくある質問
Context Modeは無料で使えますか。
はい。無料で利用でき、アカウント登録は不要です。ライセンスはElastic License 2.0（ELv2）で、ソースコードは公開されていますがOSI承認の狭義のオープンソースとは異なるソースアベイラブル型のライセンスです。
どのAIコーディングエージェントで使えますか。
READMEによれば17クライアントに対応し、Claude Code・Cursor・Gemini CLI・VS Code Copilot・Codex CLIなどが含まれます。ただしフックによるルーティング強制の実効性はクライアントによって差があります。
本当に98%も削減できますか。
開発元公表のベンチマークでは、Playwrightスナップショットで約99%、GitHub Issue取得で約98%の削減事例が示されています。ただし第三者による独立検証は2026年9月時点で確認できておらず、実際の削減率はツールの種類やプロジェクト内容によって変動します。
OpenVikingやECCとは何が違いますか。
OpenVikingは記憶・知識・スキルの長期管理に主眼を置く外部コンテキストデータベース、ECCはエージェントハーネス全体の運用最適化スイートです。Context Modeはツール出力が生成された瞬間にサンドボックスで処理し、要約のみをコンテキストへ返す点に特化しています。
標準の/compactコマンドと併用できますか。
はい。/compactは会話履歴全体を事後的に圧縮する機能であるのに対し、Context Modeはツール出力を事前に削減する仕組みで、両者は役割が異なるため併用が前提です。
この記事に関連する無料ツール（登録不要・その場で結果）
お気軽にご相談ください
お問い合わせ