为什么需要
AI Agent 操作代码库时,要处理 PowerShell 转义、路径引号、UTF-8 编码、平台差异——这些脏活消耗 LLM 大量的 context 和 reasoning 注意力。一个简单的文件读取可能要 3-5 轮工具调用才确认命令拼对了。FastCtx 用 Rust 实现了一套原子的 MCP 工具,把这些脏活封装好,让 LLM 一次调用就拿到干净的输出。
和 RTK 的差异:RTK 优化 shell 命令输出(cat、grep、git 等),FastCtx 优化文件级操作(read、search、replace),两者互补不冲突。
怎么用
bash
npm install --global fastctx
fastctx
启动控制终端,AI Agent 通过 MCP 协议调用:
typescript
// 一次性读取文件 + 搜索 + 替换
{
"tool": "fastctx_replace",
"params": {
"file": "src/auth.ts",
"find": "const old = 1;",
"replace": "const new = 2;"
}
}
对 ChatGPT App 和 Codex CLI 有一键适配,其他 MCP 客户端注册 fastctx serve 即可使用。
使用案例
独立开发者用 Codex 改造 5 万行的老代码库做海外迁移。开启 FastCtx 后,原本每次文件读取要 2-3 轮 shell 命令(cat → 处理分页 → 处理编码),现在一次 MCP 调用搞定。改造一个认证模块从 30 分钟降到 12 分钟,整个项目周期缩短约 30%。
另一个场景:在 CI 里跑 AI Agent 自动修 bug,FastCtx 让 Agent 的工具调用日志从 200 行降到 40 行,CI 日志可读性提升,调试效率翻倍。
注意事项
- 完全免费开源,Apache-2.0 协议
- 单 Rust 二进制,启动毫秒级,资源占用低
- 当前主要适配 ChatGPT App 和 Codex CLI,其他 Agent 通过通用 MCP 协议接入
- 持久进程模型,运行时间长后会累积内存(推荐每 24 小时重启一次)
- 文档中英双语(README.zh-CN.md)