Context Mode

社区

为 AI 编程代理优化上下文窗口。

分类: 开发工具第 199 / 438
Stars: ★ 30.8k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22.5+ · Bun
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 8 天前
工具数: 11

54FMRS · D

Context Mode 面向 AI 编程代理的上下文治理：通过隔离执行、输出过滤、索引检索、缓存和会话追踪减少上下文消耗。它覆盖多个客户端，但安装复杂度、自动路由能力和 hooks 支持因客户端而异；使用前应评估本地代码执行、凭据继承和持久化索引风险。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 8/20

可靠性

10/20

安全与权限

8/20

维护活跃度

10/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 10/20: README 描述了 MCP 初始化、11 个工具、多平台适配、SQLite 后端、运行时要求和若干故障处理路径，快乐路径看起来可行。但服务器清单未缓存，缺少可核验的工具 schema、实现代码、CI 和提交测试；平台钩子、运行时和数据库分支较多，错误处理与边界行为无法静态确认，因此不得高于 12 分并扣分。
安全与权限 8/20: README 明确说明沙箱使用独立子进程、仅将 stdout 暴露给上下文，并披露凭据会传递给 gh、aws、gcloud、kubectl、docker；这支持一定的数据边界判断。但它允许执行多种语言、访问本地文件和外部 URL，凭据路径与网络范围未细化，也未说明危险操作的确认机制；ctx_purge 会永久删除索引内容，ctx_upgrade 会拉取最新版本并重建配置。未见恶意窃取或隐蔽外传证据，但权限和确认控制不完整。
维护活跃度 10/20: 仓库未归档，且 README 展示了持续维护相关信号、问题追踪链接和升级命令；但仅有 104 个开放 issue 和 README 徽章不能证明发布节奏、响应质量、依赖更新或安全响应流程。仓库元数据为 NOASSERTION，而 README 徽章标称 ELv2，许可证证据不一致；缺少明确维护者、版本策略和安全渠道，因此只能给中等分。
文档质量 14/20: README 覆盖了大量客户端的安装、配置、验证、工具用途、运行时前提、缓存 TTL、索引机制、限流、平台限制和部分故障排查，且给出具体配置示例。扣分点是 manifest 未缓存、工具参数/schema 不完整、认证与网络数据流边界说明不足、成本和安全确认机制未充分说明，且提供的 README 材料在会话连续性章节处截断，无法核验完整文档。
安装易用性 12/20: README 为许多主流客户端提供了从运行时准备到 MCP 配置和验证的示例，部分平台支持插件和自动钩子。扣分原因是通常要求 Node.js >=22.5、全局安装、手工编辑多个配置或规则文件；不同客户端的插件、钩子、信任和特性开关差异显著，部分平台只有约 60% 的手册遵循率，且缺少 manifest 和实际连接测试证据。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

使用受支持 AI 编程 CLI、IDE 或代理的开发者
需要处理大型代码库、日志、网页或批量查询的团队
希望在上下文压缩后恢复工作状态的用户

不适合谁

需要图形界面专用 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 22.5+ · Bun

其他可选配置项（4 个）

CONTEXT_MODE_PLATFORM 可选手动指定平台身份（如 copilot-cli、antigravity-cli、codex），用于覆盖自动检测；仅特殊安装路径需要。

CONTEXT_MODE_DIR 可选 Codex 无法写入默认存储目录时，指定一个可写的绝对路径作为会话与索引存储根目录。

OPENCLAW_STATE_DIR 可选 OpenClaw 插件安装器的状态目录路径，默认为 /openclaw，仅 OpenClaw 安装时使用。

COPILOT_HOME 可选使用隔离的 Copilot 主目录时需要先设置，Copilot CLI 才能找到正确的 hooks 配置。

根据客户端选择对应配置。通用 MCP-only 方式是先运行 npm install -g context-mode，再将服务器命令配置为 context-mode；README 也提供了 Claude Code 的命令 claude mcp add context-mode -- npx -y context-mode。需要自动路由和会话追踪时，应按目标客户端文档额外配置 hooks、插件或规则文件。

.mcp.json

{"mcpServers":{"context-mode":{"command":"npx","args":["-y","context-mode"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "context-mode": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端会话中输入 `ctx stats`（或运行 /context-mode:ctx-doctor），如果所有 ctx_* 工具出现并返回统计/诊断结果，说明 MCP 服务器已连接。

常见排障

确认 Node.js 版本满足目标客户端要求；多数配置要求 Node.js >= 22.5。
运行 context-mode doctor 或客户端对应的 ctx doctor 检查运行时、hooks、FTS5、版本和 MCP 注册。
使用 ctx stats 验证 MCP 工具是否可用并查看节省统计。
检查客户端配置路径、命令 PATH、插件信任状态以及是否重复注册 MCP 与插件。
Linux、旧版 glibc、Windows 或原生 SQLite 绑定异常时，按 README 的构建前置条件和自修复说明检查安装。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 ctx_execute 跑一段 JavaScript 脚本，统计 src 目录下每个 TypeScript 文件的行数，只输出结果。
用 ctx_fetch_and_index 抓取这个文档页面并建立索引，然后用 ctx_search 查一下它的缓存配置说明。
给我看 ctx_stats，说明这次会话节省了多少上下文。
用 ctx_batch_execute 一次性运行这几个 git 命令，把输出压缩后再给我。

工具能力 11

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、版本和注册状态。

展开其余 3 个工具

ctx_upgrade 写入

从 GitHub 升级到最新版本、构建并重新配置 hooks。

ctx_purge 破坏性

永久删除知识库中的全部已索引内容。

ctx_insight 只读

在浏览器中打开托管的 Insight 仪表板。

使用场景

压缩大型命令、日志、网页和代码分析结果的上下文占用

将文件或网页内容建立可检索的持久索引

跨会话保存编辑、git 操作、任务、错误和用户决策

使用脚本批量分析文件，而不是将大量原始内容读入上下文

支持客户端

Claude Code

Gemini CLI

VS Code

JetBrains Copilot

GitHub Copilot CLI

Cursor

OpenCode

KiloCode

OpenClaw / Pi Agent

Codex

Kimi Code

Qwen Code

Antigravity IDE部分支持

Antigravity CLI

Kiro

Zed部分支持

Pi Coding Agent

OMP

依据项目文档列出，未经本站实测。

详细介绍

Context Mode 是一个通过 MCP 与 hooks 优化 AI 编程代理上下文使用的服务器。它将工具输出放入隔离子进程，仅将标准输出返回上下文；支持会话记忆、SQLite FTS5/BM25 索引、相关内容检索、批量执行和跨多个编程客户端的路由 enforcement。README 声称典型工具输出可减少约 98%。