Remote MCP · 代码库上下文，不烧 token
让 agent 一次拿到该看的代码，不多不少
agent 读不完整个仓库，也不该靠 grep 碰运气，更不该为重复读过的文件烧 token。Context Engine 在远端为你的代码库建混合索引；每次提问，三路检索并行召回、重排去重，按你设定的 token 预算返回文件级上下文包。对 agent 只暴露一个 MCP 工具，接入只需一段配置。
Claude Code · Cursor · 任何 MCP client / 免费额度注册即送
❯
- src/session.ts0.94
- src/auth/jwt.ts0.87
- src/db/user.ts0.00
- src/api/login.ts0.81
- src/middleware/rate.ts0.00
- src/utils/hash.ts0.00
- src/config.ts0.00
→ context pack0 / 8,000 tokens
$ stats --live
MCP 工具，索引与检索全封装
语义 + 关键词 + 符号图并行召回
tree-sitter AST 级解析与切块
按 token 预算精确裁剪返回
> cat ./setup.json # 接入
一段配置，agent 就多了一双眼睛
把这段 JSON 加进你的 MCP client 配置，剩下的交给 codebase_context。
{
"mcpServers": {
"context-engine": {
"command": "npx",
"args": ["-y", "@code-context-engine/mcp@latest"],
"env": {
"CONTEXT_ENGINE_REMOTE_API_KEY": "<cek_ key>"
}
}
}
}> ls ./why-context-engine/ # 为什么是 Context Engine
检索质量，是 agent 产出质量的上限
喂进上下文的代码决定了 agent 能不能改对地方。我们把检索当成核心工程问题来做，而不是一次 embedding 查询。
--access
一个工具，接完即用
对 agent 只暴露 codebase_context 一个 MCP 工具。本地文件增量同步、远端索引、检索、反馈闭环全部封装在工具内部，一段 JSON 配置即可接入。
--recall
混合检索 + 符号图扩展
语义向量与关键词双路召回，跨语言符号图沿调用关系扩展相关代码，重排后按文件聚合——比单靠 embedding 或 grep 都更接近「该看的代码」。
--budget
token 预算内精确裁剪
每次返回都控制在你设定的 token 预算内，span 级裁剪并附带分数与命中来源，不再挤爆 agent 的上下文窗口。
--sync
增量同步，秒级更新
客户端按内容哈希计算 manifest 差异，只上传变更文件；服务端增量重建索引，改一个文件不用重索引整个仓库。
--parse
AST 级代码理解
基于 tree-sitter 对 TypeScript、Python、Go、Rust、Java 等 12+ 语言做语法树切块，按函数与符号边界组织上下文，而不是盲目按行切。
--feedback
反馈驱动的质量闭环
agent 可以对每次结果回传质量反馈，服务端沉淀为评测集与训练数据，检索质量随使用持续改进。
> sh ./pipeline.sh # 工作原理
三步，从本地仓库到精准上下文
01 · 同步 [OK]
本地增量上传
MCP client 扫描仓库计算 manifest，只上传新增和变更的文件。首次同步后，日常改动秒级完成。
02 · 索引 [OK]
远端建混合索引
服务端做 AST 切块、向量化、关键词索引和符号图构建。索引常驻远端，团队成员与多个 agent 共享。
03 · 检索 [OK]
agent 直接提问
agent 调 codebase_context 传入自然语言问题，拿回按文件聚合、带分数与命中 span 的上下文包。
> cat ./security-boundary.md # 数据边界
你的代码，边界清晰
租户隔离的 workspace
每把 API key 对应独立 workspace，仓库、索引、用量跨租户互不可见。
key 随时可轮换
控制台一键生成新 key，旧 key 立即失效；key 只在生成时显示一次。
删除即停用
项目删除后立即停止服务并作废剩余额度，数据按保留策略清理。
路径与体积双重校验
上传文件经内容哈希校验与路径边界检查，服务端拒绝一切越界写入。
> ./billing --plans # 定价
订阅制，按检索次数计额度
每 30 天一个周期，额度自动重置。只有 agent 拿到上下文包的那一次调用计次——文件同步、建索引、质量反馈都免费。
--plan=Free
登录自动开通，先跑通再说
- 每月 50 次检索调用
- 仓库数量不限，增量同步免费
- 混合检索 + 符号图扩展
- 独立 workspace，租户隔离
--plan=Pro
个人开发者的日常主力
- 每月 500 次检索调用
- 仓库数量不限，增量同步免费
- 混合检索 + 符号图扩展
- 独立 workspace，租户隔离
--plan=Max
个人开发者的日常主力
- 每月 5,000 次检索调用
- 仓库数量不限，增量同步免费
- 混合检索 + 符号图扩展
- 独立 workspace，租户隔离
> read_faq --all --verbose # 常见问题
关于计费与数据，你想问的
什么算一次计费调用？
只有 agent 实际拿到上下文包的那次 codebase_context 调用计一次。文件同步、索引构建、质量反馈全部免费，不占额度。
免费额度怎么领？
GitHub 登录即自动开通免费套餐，每个周期的额度自动重置，不需要绑卡。
支持哪些 coding agent？
任何支持 MCP 的 client 都能接入：Claude Code、Cursor、Windsurf 等。配置就是一段标准的 MCP JSON。
我的代码存在哪里，安全吗？
代码索引存储在你专属的 workspace 里，租户之间完全隔离。API key 随时可轮换，删除项目立即停止服务并按保留策略清理数据。
额度用完了会怎样？
检索调用会返回明确的额度不足提示（HTTP 402），agent 不会静默拿到空结果。你可以升级套餐或等下个周期额度重置。
大仓库 / monorepo 能用吗？
可以。首次同步后全部是增量：客户端按内容哈希只上传变更文件，服务端增量重建索引，改一个文件不需要重索引整个仓库。
检索质量比直接 grep / embedding 好在哪？
三路并行召回（语义向量、关键词、符号图）互补盲区，再经重排去重、按文件聚合、span 级裁剪。每个结果带分数与命中来源，可解释也可反馈。
$ 现在开始
五分钟，给你的 agent 换一副眼睛
GitHub 登录即送免费额度，接入只需一段 MCP 配置。