AI 编程工具
SyntaxRAG：面向 AI 代理的本地代码检索 MCP 引擎
EnmanuelReynoso23/synrag · Local MCP code search that cuts AI agent tokens: AST chunks, CPU reranking and a dependency impact graph. -63.9% tokens measured.
ELI5：它是什么，解决什么问题
SyntaxRAG（SYNRAG）是一个本地代码搜索 MCP 引擎，通过 Tree-sitter 按函数、类、类型等 AST 结构切分代码，在 CPU 上用 FlashRank（TinyBERT）对 BM25 候选重排序，并构建依赖影响图。它提供搜索、文件大纲、仓库地图、影响范围分析、测试定位及受控编辑等工具，以减少 AI 代理定位代码时的 token 消耗；附带安装脚本、CLI、可选的变更监视服务和 Gemini 相关可选功能。
核心能力与快速开始
★ 1 · Python
- 能做什么
- 按 AST 结构切分 TypeScript、TSX、JSX、JavaScript、Python 代码，并对 Markdown、MDX、reStructuredText、AsciiDoc 与 SQL 做分段；以 BM25 召回加 FlashRank ONNX 重排的方式在本地检索符号定义、用法与文件大纲；构建导入依赖图和影响半径分析；提供仓库签名地图、文档检索、重复代码发现、相关测试查找、调用点检查，以及保留格式的补丁、导入整理、符号重命名等编辑工具；含 CLI、MCP 服务、安装器与可选文件变更监视服务。
- 适用场景
- 为 Claude Code、Google Antigravity 及其他 MCP 客户端提供本地代码检索与导航；在修改代码前评估依赖影响范围；在 token 预算内生成仓库结构概览或仅含签名的打包文件；定位并运行相关测试；减少终端长输出占用的上下文。
- 项目形态
- 可直接使用的工具
- 部署方式
- 通过 curl 一行安装脚本或克隆仓库后执行 install.sh 安装；安装器创建 CPU 虚拟环境并在 ~/.local/bin 写入启动器，自动配置检测到的 AI 客户端。作者仅在 Linux（CachyOS）实际测试，macOS、其他发行版及 Windows WSL 未验证。
- 主要依赖
- Python 3.10+；本地索引与 CPU 重排；可选变更监视服务约占用 250-300 MB 内存；可选的 Gemini 相关工具需自行配置 GEMINI_API_KEY，否则引擎不联网。未说明其他硬件或 API 成本。
- 使用限制
- 依赖图不追踪动态调用与 import()；重复查询缓存并非语义缓存，重建索引时清空；部分 MCP 客户端仅按文档配置而未实测；token 节省数据来自仓库自带基准脚本，特定任务（如短输出测试）可能反而增加 token；检索结果仍需由模型读取并消耗 token。
- 许可证
- MIT
- 最近推送
- 2026-10-30 10:12
资料检查：2026-10-31 07:00 · 卡片整理：2026-10-31 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证
职业应用
程序员
作为本地 MCP 代码检索引擎，供 AI 编程代理在编写、审查和排错时按 AST 结构定位函数、类与类型定义，查看文件大纲和仓库地图，分析依赖影响范围、查找相关测试与调用方，并在受控范围内编辑代码，从而减少代理读取整个文件所消耗的 token。
查看内容依据
Motor local de búsqueda de código para agentes de IA, por el protocolo MCP.
由 AI 根据来源材料整理，未进行安装或运行验证
讨论 0
登录后参与讨论，阅读资讯无需注册。
还没有评论，来分享第一个看法。