fastctx

让 AI 代理按需读代码，省 token 又找得准

fastctx 是一个用 Rust 编写的 MCP（Model Context Protocol）服务器，为 AI 编码代理提供高效、上下文友好的代码仓库工具。它解决的核心问题是：AI 代理在操作大型代码库时，往往需要把大量文件内容塞进上下文窗口，既浪费 token 又降低推理质量。fastctx 通过提供结构化的仓库检索与读取能力，让代理按需获取精准的代码片段，而不是一次性吞下整个目录。核心能力包括快速文件搜索、按符号或路径定位代码、受控的上下文输出，以及基于 MCP 标准与 Claude、Cursor 等客户端无缝集成。Rust 实现带来低延迟和低内存占用，适合在本地或 CI 中常驻运行。项目定位是 AI 代理的“仓库感知层”，让代理在真实工程里更省 token、更准地找到目标代码。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1420

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队yc-duan

所属国家

官网地址

GitHubhttps://github.com/yc-duan/fastctx

定价模式free

价格说明开源免费，无官网定价信息

访问状态

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型

GitHub 星标★ 1420

30天Star增速

HF 下载量

上线时间2026-07-17 00:00:00

最近更新2026-09-21 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

难度：入门约 5 分钟部署方式：命令行工具 6 步

环境要求

Node.js 18 或更高版本
npm（随 Node.js 一起安装）
Windows 上执行 Bash 命令依赖 Git Bash，macOS / Linux 使用系统 Bash

安装与启动步骤

1检查 Node.js 版本

FastCtx 要求 Node.js 18 或更高版本，版本过低请先升级 Node.js，否则安装会失败。
```
node -v
```
2全局安装 FastCtx

通过 npm 全局安装 fastctx 包，安装完成后终端即可使用 fastctx 命令。
```
npm install --global fastctx
```
3启动控制终端

首次启动会打开全屏控制终端，可调整输出档位、并发、Bash 终端、后台任务与宿主配置等。
```
fastctx
```
4免安装临时运行

不想全局安装时可先用 npx 打开同样的控制终端；但 fastctx 命令本身仍需要全局安装。
```
npx fastctx
```
5安装报 404 换官方源

刚发布时镜像源同步延迟会导致 404，改用官方源安装；该参数只对本次命令生效。
```
npm install --global fastctx --registry=https://registry.npmjs.org/
```
6连接宿主客户端

在连接界面确认宿主配置变更并重启 ChatGPT / Codex 会话，连接会把二进制复制到 ~/.fastctx/bin/。

关键配置

配置项	必填	说明	示例
`FASTCTX_DISABLE_UPDATE_CHECK`	否	设为 1 可关闭控制终端启动时的自动更新检查。	`1`
`registry`	否	npm 源地址，改成官方源可规避镜像同步延迟导致的 404。	`https://registry.npmjs.org/`

如何确认成功

终端出现 FastCtx 全屏控制终端主菜单，且 fastctx 命令可正常调用，即表示安装启动成功。

常见问题

Q：安装后提示 404 Not Found 怎么办？

A：多为镜像源同步延迟，平台包被静默跳过导致无法启动。改用官方源重装：npm install --global fastctx --registry=https://registry.npmjs.org/。

Q：npx fastctx 和全局安装有什么区别？

A：npx 无需全局安装即可打开同一控制终端，且连接后二进制同样复制到 ~/.fastctx/bin/；但只有全局安装后才有 fastctx 命令。

Q：更新之后需要做什么？

A：更新完成后需要重启 Codex，让已有会话及其构建隔离的控制中心被新构建替换，否则仍在使用旧版本。

Q：如何关闭启动时的更新检查？

A：设置环境变量 FASTCTX_DISABLE_UPDATE_CHECK=1，即可禁用控制终端启动阶段的自动检查。

注意事项

连接宿主时会把当前二进制复制到 ~/.fastctx/bin/，之后清理 npm 缓存或升级都不影响已连接的配置。
cargo install 构建出的版本和内部 ~/.fastctx/bin/ 运行时不会自动更新，只能通过 npm 或 GitHub Release 方式更新。
命令在非交互环境中执行，安装、确认、编辑器类命令需要显式加 -y、--no-edit 等参数，否则会卡住。
后台任务的输出与退出状态存放在 ~/.fastctx/jobs/ 下，可在其它 FastCtx 会话中按 job id 继续查看。

核心亮点

Rust 实现，启动和检索延迟低，适合常驻 MCP 服务
按需返回代码片段而非整目录，显著节省上下文 token
遵循 MCP 标准，可直接接入 Claude Desktop、Cursor 等支持 MCP 的客户端

不足之处

项目较新，星标约 1.4k，生态集成和边界场景覆盖仍在完善
文档与社区案例相对有限，复杂仓库的检索效果需自行验证

适用场景

让 Claude/Cursor 代理在大型仓库中快速定位并读取目标函数
在 CI 或本地常驻 MCP 服务，为多轮编码任务持续提供仓库上下文
代理重构或排查 bug 时，按符号/路径精准拉取相关代码而非全量文件

替代项目

serena、mcp-server-git

项目介绍

fastctx 是开发框架领域的开源项目，由 yc-duan 开发，是 2026 年新上线的项目。

在全站 12,909 个收录项目中，它的 GitHub 星标数（1,420）位列前 30%，在开发框架分类中处于中上游。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-21。开源免费，无官网定价信息。

它主要面向的使用场景是：让Claude/Cursor代理在大型仓库中快速定位并读取目标函数。同类可对比的替代方案包括 serena、mcp-server-git。

上一篇：create-context-graph

下一篇：没有了！