作者 MinishLab · MinishLab/semble
程式碼搜尋的 token 耗用僅約 grep+read 的 2%——語義 + 詞彙雙重搜尋，完全本機，百萬行規模的 repo 也能在次秒內回應。
Semble 是 Minish Lab 出品的程式碼搜尋 MCP。它用混合稀疏+稠密嵌入為 repo 建立索引，提供比 grep 更精準的語義搜尋結果——無需傾印整個檔案。與標準的「grep 後讀取」模式相比，token 耗用大幅降低，在大型 monorepo 上尤為顯著。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"semble-mcp": {
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"semble-mcp": {
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"semble-mcp": {
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"semble-mcp": {
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "semble-mcp",
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"semble-mcp": {
"command": {
"path": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add semble-mcp -- uvx --from semble[mcp] semble一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 你需要一次回答「session 驗證邏輯在哪裡？」
semble index .——第一次對大型 repo 需要幾分鐘結果： 以 grep+read 耗費的一小部分 token 取得問題的解答。
semble reindex 或設置檔案監視鉤子何時使用： 你要廢棄一個 helper，想找出它的所有使用位置和變體。
legacy_token_check 的呼叫。✓ 已複製結果： 開始重構前就完全掌握影響範圍。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| search | query, k?, mode? | 預設——依概念查找 | 免費 |
| lexical_search | pattern, k? | 精確 token 或正則表達式 | 免費 |
| index | path | 第一次執行或大型重構後 | 免費 |
| reindex | path | 編輯後補上更新 | 免費 |
本機檔案讀取（用於建立索引）大型 repo 建立索引時記憶體不足在設定中降低批次大小，或按套件分別建立索引
搜尋沒有回傳相關結果重新建立索引——本機副本可能已偏移；或精修查詢
uvx 安裝卡住提前暖機：uv pip install semble[mcp]
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| ripgrep + grep MCP | 你只需要精確匹配搜尋 | 無語義召回；結果的 token 成本更高 |
| ast-grep / serena | 你想要語法感知的結構性搜尋替換 | 不同模型；非基於嵌入 |