适合谁
- 使用受支持 AI 编程 CLI、IDE 或代理的开发者
- 需要处理大型代码库、日志、网页或批量查询的团队
- 希望在上下文压缩后恢复工作状态的用户
C
54FMRS · D
Context Mode 面向 AI 编程代理的上下文治理：通过隔离执行、输出过滤、索引检索、缓存和会话追踪减少上下文消耗。它覆盖多个客户端，但安装复杂度、自动路由能力和 hooks 支持因客户端而异；使用前应评估本地代码执行、凭据继承和持久化索引风险。
Context Mode 是一个通过 MCP 与 hooks 优化 AI 编程代理上下文使用的服务器。它将工具输出放入隔离子进程，仅将标准输出返回上下文；支持会话记忆、SQLite FTS5/BM25 索引、相关内容检索、批量执行和跨多个编程客户端的路由 enforcement。README 声称典型工具输出可减少约 98%。
工具能力
ctx_batch_execute
在一次调用中运行多个命令并搜索多个查询，可选择并发执行。
ctx_execute
在隔离子进程中运行 12 种语言的代码，仅将标准输出返回上下文。
ctx_execute_file
在沙箱中处理文件，不将原始文件内容带出。
ctx_index
将 Markdown 内容按标题分块并索引到 SQLite FTS5。
ctx_search
在已索引内容中搜索并返回相关片段。
ctx_fetch_and_index
抓取 URL、转换为 Markdown 并索引，支持 TTL 缓存和批量请求。
ctx_stats
显示上下文节省量、调用次数和会话统计。
ctx_doctor
诊断运行时、hooks、FTS5、版本和注册状态。
ctx_upgrade
从 GitHub 升级到最新版本、构建并重新配置 hooks。
ctx_purge
永久删除知识库中的全部已索引内容。
ctx_insight
在浏览器中打开托管的 Insight 仪表板。
安装接入
根据客户端选择对应配置。通用 MCP-only 方式是先运行 npm install -g context-mode，再将服务器命令配置为 context-mode；README 也提供了 Claude Code 的命令 claude mcp add context-mode -- npx -y context-mode。需要自动路由和会话追踪时，应按目标客户端文档额外配置 hooks、插件或规则文件。
claude_desktop_config.json
{"mcpServers":{"context-mode":{"command":"npx","args":["-y","context-mode"]}}}
选型与风险
不适合谁
- 需要图形界面专用 MCP 集成但未列出客户端支持的用户
- 只需要简单 MCP 工具且不希望安装 hooks、插件或本地索引的用户
- 不希望代理执行本地脚本或访问本地文件、凭据和网络资源的环境
所需权限
- 需要在本地运行 Node.js、Bun 或其他列出的语言运行时。
- 沙箱脚本可读取和处理本地文件，并可通过继承的环境变量和配置使用 gh、aws、gcloud、kubectl、docker 等已认证 CLI。
- ctx_fetch_and_index 需要抓取 URL；索引内容保存在用户目录下的 SQLite 数据库中。
- 启用 hooks 或插件后，服务器可拦截部分工具调用、记录会话事件并执行路由规则。
风险与副作用
- ctx_execute 等工具会运行用户或代理提供的代码；代码可能读取本地文件、调用命令或使用可继承的凭据。
- 会话和索引内容会持久化到本地 SQLite 数据库；ctx_purge 会永久删除全部已索引内容。
- hooks 可能阻止或重定向部分工具调用；不同客户端的路由能力并不相同。
- README 中的节省比例是项目自述指标，实际效果取决于工具输出和使用方式。
常见排障
- 确认 Node.js 版本满足目标客户端要求；多数配置要求 Node.js >= 22.5。
- 运行 context-mode doctor 或客户端对应的 ctx doctor 检查运行时、hooks、FTS5、版本和 MCP 注册。
- 使用 ctx stats 验证 MCP 工具是否可用并查看节省统计。
- 检查客户端配置路径、命令 PATH、插件信任状态以及是否重复注册 MCP 与插件。
- Linux、旧版 glibc、Windows 或原生 SQLite 绑定异常时，按 README 的构建前置条件和自修复说明检查安装。
使用场景
压缩大型命令、日志、网页和代码分析结果的上下文占用
将文件或网页内容建立可检索的持久索引
跨会话保存编辑、git 操作、任务、错误和用户决策
使用脚本批量分析文件，而不是将大量原始内容读入上下文
支持客户端
Claude Code完整支持
Gemini CLI完整支持
VS Code Copilot完整支持
JetBrains Copilot完整支持
GitHub Copilot CLI完整支持
Cursor完整支持
OpenCode完整支持
KiloCode完整支持
OpenClaw / Pi Agent完整支持
Codex CLI完整支持
Kimi Code完整支持
Qwen Code完整支持
Antigravity IDE部分支持
Antigravity CLI完整支持
Kiro完整支持
Zed部分支持
Pi Coding Agent完整支持
OMP (Oh My Pi)完整支持