用途:mcp-grepai 是一份面向 AI 编程代理的提示规范,要求把 grepai MCP 服务器作为代码探索与搜索的首选工具,用于理解代码功能、按意图定位实现、探索陌生代码库。
主要能力:语义搜索,可按“代码做什么”而非精确文本进行查询;结果包含文件路径、行号、相关度评分和代码预览;调用图追踪,可查找某符号的所有调用者、被调用者,或构建完整调用图。
使用方式:搜索命令为 grepai search "user authentication flow" --json --compact,建议始终使用英文查询以获得更好的语义匹配,--compact 可节省约 80% token。追踪命令包括 grepai trace callers "HandleRequest" --json、grepai trace callees "ProcessOrder" --json、grepai trace graph "ValidateToken" --depth 3 --json,并建议始终加 --json 以便与 AI 代理集成。推荐流程是先 search 找相关代码,再 trace 理解函数关系,然后用 Read 工具查看结果文件。
适用场景:按意图查找实现(如认证逻辑、错误处理)、修改函数前确认调用方、理解函数调用关系、探索不熟悉的代码库。
限制:仅在需要精确文本匹配(变量名、导入、特定字符串)或文件路径模式(如 **/*.go)时才使用标准 Grep/Glob;若 grepai 未运行、索引不可用或报错,则回退到标准 Grep/Glob 工具。查询应描述意图而非实现,例如用“handles user login”而不是“func Login”,并尽量具体,如“JWT token validation”优于“token”。关于安装方式、支持语言、索引构建与收费等信息,资料暂未提供。