| FMRS | 64 / 100 · C | 80 / 100 · B | 79 / 100 · B |
| 可靠性 | 12 / 20 | 14 / 20 | 12 / 20 |
|---|
| 安全与权限 | 9 / 20 | 16 / 20 | 16 / 20 |
|---|
| 维护活跃度 | 14 / 20 | 17 / 20 | 18 / 20 |
|---|
| 文档质量 | 16 / 20 | 15 / 20 | 18 / 20 |
|---|
| 安装易用性 | 13 / 20 | 18 / 20 | 15 / 20 |
| 适合谁 | - 长时间、多轮次的编码代理会话
- 同时使用多个 CLI 客户端的开发者
- 需要本地运行、无遥测、可商用许可的团队
- 希望用可复现基准而不是厂商自述来验证压缩效果的团队
| - 使用变化较快的框架/库、担心 AI 助手给出过时代码建议的开发者
- 希望零配置直接获得文档检索能力的场景
| - 需要在 AI 工作流中审查 NPM 依赖的开发者
- 进行供应链安全评估的团队
- 使用 Claude Desktop、Cursor 或 VS Code 的用户
|
| 不适合谁 | - 只想安装一个纯 MCP 服务器、不希望客户端安装钩子或插件的人(README 明确说明仅加服务器无法执行强制拒绝)
- 不希望任何请求内容被写入本地磁盘的场景(代理会把被省略的载荷写入临时目录的 spill 文件)
- 需要托管服务或云端账号的用户
- 无法运行 Node.js 22+ 的环境
| - 需要检索内部私有代码库文档的场景(Context7 面向公开发布的开源库)
- 对文档来源覆盖率有极高要求、需要覆盖冷门小众库的场景(覆盖范围取决于 Context7 平台收录情况)
| - 不使用 NPM 生态(如纯 Python/Go)的项目
- 无法访问外部网络(deps.dev、OSV.dev、npm 注册表)的环境
- 需要官方上游厂商维护保证的场景
|
| 所需权限 | - 读写项目文件(智能读写与差异比较)
- 在客户端中安装并运行生命周期钩子,用于在工具执行前进行拦截或改写路由
- 在本地磁盘写入缓存、知识图谱、日志与省略内容的 spill 文件
- 可选地在本机回环地址启动一个压缩代理进程
- 读取本地 CLI 的使用账目以进行令牌计量与定价
| - 无需 API Key 即可使用(有免费额度限制),CONTEXT7_API_KEY 为可选的更高配额凭据
- 只读检索文档内容,不涉及执行代码或访问本地文件
| - 访问 NPM 注册表及 deps.dev、OSV.dev、OpenSSF、npms.io、GitHub 等外部服务的网络权限
- 读取工作区 lockfile(pnpm-lock.yaml、package-lock.、yarn.lock)以实现缓存失效
|
| 风险与副作用 | - 服务器会拒绝或改写内置工具调用(如 Read、Grep、Glob、Edit、Write 以及 shell 中的 cat/head/grep -r),在 enforce 模式下可能打断既有工作流
- 被省略的可恢复内容会以 0600 权限写入操作系统临时目录的 token-optimizer-spill/ 下,代理运行期间不会删除;若进程被强杀或断电,目录会残留,需手动清理
- 代理不会检查所写内容是否包含密钥,若对话中含有敏感信息,可能随 spill 文件落盘
- 知识图谱与缓存保存在本地,涉及项目结构、文件内容哈希与发现的结论
- README 中多项对比结果为开发阶段或未完成的研究,其自身说明未能建立全面优越性,聚合区间仍跨过 1.0
| - 免费额度有限,高频使用场景可能遇到速率限制
- 文档内容来自 Context7 平台索引,其准确性和更新频率取决于该平台的抓取周期
| - 返回的第三方 README 与 changelog 为不可信外部内容,虽然已用标签包裹并附加 _meta 标记,仍需谨慎处理
- 依赖外部服务的可用性与数据准确性
- 批量请求上限为 25 个包以防枚举滥用,超出需分批
- 第三方开源项目,非 NPM 或 Anthropic 官方维护
|
| 支持客户端 | Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, Qwen Code, Cursor, Cline, OpenCode, Kilo, Windsurf, Roo Code, Zed, Amp, Continue, Crush, Droid | Claude Code, VS Code, Cursor, Cline, Amp | Claude Desktop, VS Code, Cursor, Smithery.ai |
| 工具能力 | 11 | 2 | 19 |