本地 MCP 服务器用于令牌预算代码上下文包和可重现检索
Archex,由Mathews Tom开发,是一个MCP服务器和代码智能工具,它将大型本地代码库转换为紧凑的上下文包,以供AI编码代理使用。该工具使用tree-sitter解析提取和排名符号,并组装适合模型窗口的令牌预算包,带有上下文收据和CLI。它的目标是需要精确、本地优先上下文检索以进行代码探索和调试的软件工程师和AI研究人员。
Archex 将代码库代码转换为令牌大小的、排名的上下文包
该工具使用 tree-sitter 解析源文件以提取符号,并在 25 种以上的语言中构建一个 AST 感知索引。它使用图扩展和排名来组装一个 令牌预算 的上下文包,以适应模型窗口,并发出一份 上下文收据,记录包含的文件、跳过的项目和包的完整性。这种方法针对符号级输入,而不是简单的文件搜索。
确定性检索产生可重复的、高召回率的结果
该应用程序以确定性方式组装上下文,因此相同的查询在任何机器上返回相同的包。开发者报告在复杂任务中所需文件的召回率超过 0.95,内置基准测试工具允许团队在代码库内重现检索指标。这些元素支持检索策略和模型窗口预算选择的客观比较。
它与 MCP 客户端集成,但依赖于本地环境设置
Archex 作为与 Claude Desktop 和 Cursor 等客户端兼容的 MCP 服务器,并提供超过 20 个用于索引和探索的命令行接口。部署需要 Python 3.11 到 3.13 或 Docker 镜像,这使得服务在开发者机器或 CI 系统上运行,而不是托管索引。该设计适合愿意将本地服务作为工作流程一部分的团队。
本地优先设计保护代码库隐私并启用可验证测试
该工具在其核心路径中本地操作,执行索引和检索,而无需托管推理或遥测,也不需要外部 API 密钥进行索引。内置基准测试工具提供可验证的性能跟踪和代码库内的比较。开发者在多代理编排和评估基础设施方面有经验,这强调了对敏感代码库的可验证性和可预测行为的重视。
当可重复、可验证的上下文检索很重要时,选择 Archex
Archex 是一个实用的选项,适合需要可测量、可重复的上下文提取以支持 AI 辅助代码任务的工程团队,并且可以在本地托管服务。预计会有初始配置和 CLI 学习曲线,并将生成的建议视为在代码更改期间需要审查的起点。对于需要即插即用托管索引的工作流程,本地优先的操作模型可能不符合操作约束。