yomu (Thkt)

MCP开发工具

提供方 thkt

开发工具 未标注 无需鉴权 社区 / 第三方 Claude

yomu是一款面向AI代理的前端代码概念搜索工具,能够通过概念而非名称快速定位代码,减少搜索迭代次数,提升开发效率。

一句话选型结论

按资料字段整理

yomu (Thkt) 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

代码搜索Rust本地部署语义搜索AI辅助开发前端工具本地嵌入模型

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
yomu (Thkt)当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方thkt上游标注的维护方 thkt
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.3 KB
来自项目仓库与上游目录的原文,未做删改

英语 | 日本语

yomu

AI代理的前端代码搜索。当你不知道代码的名字时,按概念查找代码。

问题

你需要找到聊天流挂钩 vercel/ai (3535个文件),但你不知道函数被调用了 useChat.

典型的代理工作流程:```sh
glob "/chat" → 12 files. None are it (it's called use-chat.ts).
grep "stream.
hook" → 0 files.
grep "chat" → too many results. Try reading a few...
read packages/react/src/use-chat.ts → Found it. What does it import?
read packages/ai/src/ui/process-ui-message-stream.ts → Now I have context.


3-5次工具调用,反复试验,上下文窗口中有噪音。

与yomu:```sh
yomu search "streaming chat hooks"

## packages/react/src/use-chat.ts
Imports: @ai-sdk/provider-utils, @ai-sdk/ui-utils
Siblings: UseChatOptions [type_def], UseChatHelpers [type_def]

1. useChat [hook] — 58:210 (similarity: 0.85)
export function useChat({ api, ...options }: UseChatOptions): UseChatHelpers {
...full function body...
}

## packages/rsc/src/streamable-value/use-streamable-value.ts
2. useStreamableValue [hook] — 12:45 (similarity: 0.72)
...

## examples/ai-e2e-next/.../chat-context.tsx
3. useSharedChatContext [hook] — 8:22 (similarity: 0.68)
...

1个电话。实现是第一个结果——在130个包含“useChat”的文件中,索引中总共有9015个块。

每个结果都包括完整的代码体、文件导入和兄弟定义。不需要后续阅读。

为什么不只是grep?

Claude Code的开发人员发现 这种代理搜索——让模型迭代地使用glob和grep——在代码导航方面优于RAG。他们是对的。当代理可以使用不同的关键字重试、读取目录结构并优化其搜索时,grep的工作效果非常好。

yomu不会与这种工作流程竞争。它 减少迭代次数:

方法 调用 上下文窗口成本
grep/glob(迭代) 3–5 每次失误都会增加噪音
yomu搜索 1 代码+导入+兄弟姐妹在一个响应中

经典的RAG问题——索引同步延迟、陈旧嵌入、冷启动——得到了解决:

解决方案 详细信息
无同步延迟 每 search 检查索引新鲜度,如果文件发生更改,则自动重新分块
不需要API密钥 本地嵌入模型,当模型不可用时,FTS5全文回退
增量嵌入 每次搜索调用50个块,大多数导入的文件优先。无需前期构建

当你知道grep的名字时,它是一个合适的工具。yomu是在那之前的一刻——当你知道概念但不知道标识符的时候。

何时使用yomu(何时不使用)

yomu grep/glob
你不知道代码叫什么 你知道确切的名字(grep "useAuth" 更快)
grep返回的结果太多——你需要impl 你需要正则表达式匹配或精确的字符串搜索
您希望在一次调用中包含代码+导入+相关类型 代码库很小,很熟悉

yomu不能取代grep。它涵盖了grep不能的情况:按概念搜索。

设置

安装```sh

brew install thkt/tap/yomu


或者从源代码构建(需要Rust 1.85+):```sh
cargo build --release

配置

语义搜索使用局部嵌入模型(鲁里V 3约1.2GB)。如果模型已经在本地缓存, search 自动使用它-不需要API密钥。

如果模型未安装或不可用, search 返回到纯文本模式(FTS5)。所有其他命令(index, rebuild, impact, status)没有模型的工作。

没有手动索引。 search 第一次调用时自动索引。

平台说明

平台 构建命令
macOS(苹果硅) cargo build --release (默认:mlx后端)
Linux/x86 cargo build --release --no-default-features --features candle

命令

全球旗帜

标志 描述
--json 输出为JSON(所有命令)

--json 可以出现在子命令之前或之后:```sh
$ yomu --json status
{"files":42,"chunks":187,"embedded_chunks":187,"embeddable_chunks":187,"embed_percentage":100,"references":156,"last_indexed":"2025-03-29 01:23:45"}


### `yomu search [query]` --按概念搜索

返回带有完整上下文的排名结果。每个结果包括:

|包括|为什么|
| -------------- | ------------------------------------------------ |
|完整代码体|无后续 `read` 需要|
|文件导入|不打开另一个文件的依赖关系上下文|
|Sibling defs |同一文件中的其他函数/类型|
|块类型|组件/钩子/类型_def/css_rule/rust_fn|

选项:

|标志|默认值|描述|
| ------------ | ------- | ------------------------------------------------------------------------ |
| `--limit` |10 |最大结果(最大值:100)|
| `--offset` |0|分页偏移(最大值:500)|
| `--from` |--|搜索与文件或符号类似的代码(`src/foo.rs` 或 `src/foo.rs:my_fn`).查询变为可选|
| `--no-embed` |false |跳过嵌入查找;仅使用FTS5。效果与 `YOMU_EMBED=0` |

`--from` 使用目标的存储嵌入——不需要重新嵌入:```sh
yomu search --from src/query/mod.rs           # files similar to this file
yomu search --from src/query/mod.rs:rerank    # files similar to this function
yomu search --from src/query/mod.rs "filter"  # hybrid: similar to file + FTS on "filter"

yomu impact --爆炸半径变化

显示哪些文件依赖于目标文件或符号。```sh
$ yomu impact "packages/ai/src/ui/ui-messages.ts" --symbol UIMessage --depth 2

Impact analysis: packages/ai/src/ui/ui-messages.ts

Direct symbol references

  • packages/ai/src/ui/process-ui-message-stream.ts
  • packages/react/src/use-chat.ts
    ...34 files

All transitive dependents

Depth 1

  • packages/ai/src/ui/process-ui-message-stream.ts
    ...37 files

Depth 2

  • packages/react/src/use-chat.ts
    ...18 files

Total: 55 dependent file(s)


vercel/ai的实际输出。一个调用替换了手动跟踪导入。

选项: `--symbol` (可选,过滤到特定导出), `--depth` (默认值:3,最大值:10)

`--json` 返回结构化响应。 `dependents[].references` 为直接(深度=1)边填充,并列出每个边 `(ref_kind, via_symbol)` 从源文件中配对。传递性(深度>=2)依赖项通过中间文件到达目标,因此它们的 `references` 是 `[]`:```json
{
"target": "src/storage.rs",
"in_index": true,
"dependents": [
{
"file_path": "src/indexer.rs",
"depth": 1,
"references": [
{"ref_kind": "named", "via_symbol": "Db"},
{"ref_kind": "named", "via_symbol": "open_db"}
]
},
{
"file_path": "src/main.rs",
"depth": 2,
"references": []
}
],
"symbol_refs": [],
"total": 2
}

ref_kind 是其中之一 named / default / namespace / type_only / side_effect. via_symbol 是 null 用于名称空间/副作用导入,其中在导入站点上没有命名单个符号。

yomu index / yomu rebuild / yomu status

命令 详细信息
index 更新块索引。没有API调用,对3535个文件约2.5秒。通常不需要-- search 自动索引
rebuild 从头开始完全重新解析
status 文件、块、嵌入覆盖率、引用

运作原理```text

Source files → tree-sitter AST → Semantic chunks → Local embeddings (Ruri v3) → Hybrid search


|阶段|详细信息|
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|索引|树形图在函数/组件/类型边界处拆分代码。每个块都是一个可搜索的单元。导入图是在同一通道中构建的。在vercel/ai:3535个文件上→ 9,015个区块+5026个导入引用,2.5秒,零API调用|
|嵌入|块通过本地模型(Ruri v3,310M参数)增量嵌入。每个50块 `search` 调用,按导入计数进行优先级排序——最常用的代码首先被搜索。无需预先构建|
|搜索|三层混合:向量相似性→ 名称/路径匹配→ FTS5全文。使用IDF加权关键字评分重新排名。经常导入的文件排名更高,测试文件排名更低|

## 支持的文件类型

|类型|解析器|块类型|
| ---------------- | ----------- | ------------------------------------------------------ |
|TypeScript/TSX |树保姆|组件、钩子、type_def、test_case、其他|
|JavaScript/JSX|树保姆|组件、钩子、type_def、test_case、其他|
|Rust |树保姆|Rust_fn、Rust_struct、Rust_enum、Rust_trait、Rust_impl|
|CSS |树形图| CSS_rule(选择器、@media、@关键帧)|
|HTML |树保姆|HTML_element|

其他文件则退回到基于字符的重叠分块。

## 局限性

|限制|详细信息|
| ------------------------- | ------------------------------------------------------------------------------------------- |
|模型未自动下载|必须预缓存约1.2 GB的嵌入模型; `search` 不自动下载|
|不支持SCSS/Sass |仅支持纯CSS|
|冷启动|首先 `search` 调用分块+初始嵌入需要几秒钟的时间|
|跳过大文件|超过1 MB的文件将被排除在索引之外|
|嵌入选择退出|通过 `--no-embed` 到 `yomu search`,或设置 `YOMU_EMBED=0`; `search` 回退到纯文本模式|

## 发展

### 设置

克隆后运行一次:```sh
git config --local core.hooksPath .githooks

这将安装一个运行的预提交钩子 cargo fmt --check 和 cargo clippy --all-targets --all-features -- -D warnings 每次提交之前。违规行为会中止提交。跳过一次提交: git commit --no-verify.

常用命令```sh

cargo test # all tests
cargo clippy --all-targets --all-features -- -D warnings # lint (matches CI)
cargo fmt -- --check # format check


## 建筑```text
src/
├── main.rs              CLI entry point (clap)
├── lib.rs               Crate root, public API
├── config.rs            Runtime configuration
├── modernbert.rs        ModernBERT model (mlx backend)
├── tools/               Application facade — orchestrates indexer, query, storage per command
├── indexer/
│   ├── mod.rs           Orchestration: incremental index, embed budget
│   ├── chunker/         tree-sitter AST → semantic chunks
│   ├── embedder.rs      Local embedding (ModernBERT/Ruri v3 via mlx-rs or candle)
│   └── walker.rs        File discovery, .gitignore filtering
├── resolver.rs          Import path resolution (tsconfig aliases, index.ts probing)
├── query/               Hybrid search + IDF reranking
└── storage/
├── mod.rs           Schema, CRUD, types
├── search.rs        Vector similarity, name matching, FTS5
├── embed.rs         Embedding storage, vec_chunks
└── graph.rs         Import graph traversal, dependents, siblings

单一二进制,零运行时依赖关系。SQLite和SQLite-vec是静态链接的。

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
yomu (Thkt) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

yomu (Thkt) 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

yomu (Thkt) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

yomu (Thkt) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

yomu (Thkt) 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

yomu (Thkt) 能提供哪些能力?

资料显示能力标签包括 代码搜索、Rust、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。