GenifyAI

让 AI 真正"看懂"你的代码结构

传统的代码搜索只是文本匹配——GenifyAI 不同。它用 AST 解析理解代码结构，精准定位函数、类、接口的定义位置，让 AI 助手能像资深开发者一样快速找到代码。

为什么需要它？

当你问 AI "handleSubmit 函数在哪"，普通搜索可能返回几十个包含这个词的地方。GenifyAI 直接告诉你：定义在 src/components/Form.tsx 第 42 行。

- 🎯 精准定位 - AST 级别解析，区分定义和引用
- ⚡ 极速响应 - ripgrep 粗筛 + Tree-sitter 精筛，毫秒级返回
- 🗣️ 自然语言 - 支持模糊搜索和别名，用你习惯的方式找代码
- 🌐 多语言 - TypeScript/JavaScript、Vue、Python、Solidity、HTML、CSS 等（持续扩展中）

快速开始

$3

``json
{
"mcpServers": {
"genifyai": {
"command": "npx",
"args": ["-y", "genifyai"]
}
}
}
`

> 💡 大多数客户端会自动将工作目录设为当前打开的项目。如需指定，可添加 "cwd": "/your/project/path"。

$3

现在可以直接对 AI 说：

`
"找到 UserContext 的定义"
"handleLogin 函数在哪个文件？"
"搜索所有的 interface 定义"
`

$3

在项目根目录的 CLAUDE.md 中添加：

`markdown


代码搜索策略

搜索代码定义时，优先使用 genifyai MCP 工具：

- search_symbol - 查找函数、类、接口、类型等定义位置，比 Grep 更精准
- search_fuzzy - 自然语言/关键词搜索，支持模糊匹配
- read_range - 按行号范围读取代码，配合 search_symbol 使用
- register_alias - 为代码位置注册别名，提高后续搜索命中率

使用顺序：search_symbol → read_range → 其他工具

避免直接使用 Glob/Grep 搜索符号定义，genifyai 基于 AST 解析，能区分定义和引用。

当用户用自然语言描述代码且与实际命名差异较大时，主动用 register_alias 注册别名。
`

这会让 AI 在需要定位代码时自动调用 GenifyAI，而不是反复 Read 多个文件。

---

四个核心工具

$3

按定义搜索函数、类、接口、类型等，返回精确位置。

`json
{ "query": "useState", "type": "function", "scope": "src" }
`

支持的符号类型：function class interface type enum const let var function_component class_component hook method getter setter decorator

$3

按行号范围读取文件片段，配合 search_symbol 查看具体实现。

`json
{ "filePath": "src/utils/auth.ts", "range": "[10:50]" }
`

$3

自然语言搜索，多路召回（别名、定义、文件名、文本），返回候选和匹配原因。

`json
{ "query": "用户登录", "scope": "src" }
`

$3

为代码位置绑定自定义名称，长期稳定命中。

`json
{ "term": "翻转动画", "target": "src/components/Card.tsx#flipAnimation" }
`

---

支持的语言

| 语言 | 扩展名 | 符号类型 |
|------|--------|----------|
| TypeScript/JavaScript | .ts .tsx .js .jsx | function, class, interface, type, enum, const, let, var, function_component, class_component, hook, method, getter, setter |
| Vue | .vue | 继承 TS/CSS 全部符号 + computed, watch, props, emits, component |
| Python | .py .pyw | function, class, method, decorator |
| Solidity | .sol | contract, library, interface, struct, event, modifier, error, function, enum |
| HTML | .html .htm | element (#id), component |
| CSS/Less/Sass | .css .less .sass .scss | selector, variable, keyframes |

自动忽略 node_modules、dist、build、.git 等目录，自动读取 .gitignore 规则。

---

特性亮点

导出链路跟随 - 自动解析 export { } from、export * from、export default，找到真正的原始定义位置

智能缓存 - 基于文件修改时间的 AST 缓存，避免重复解析

别名持久化 - 别名存储在 .genifyai/aliases.json`，可提交到仓库共享

---

License

MIT