jev-search-mcp

# jev-search-mcp

Jev Search for Claude Code and Codex: a function-hook plugin that answers the built-in WebSearch with Jev, plus the same search as an MCP server, a CLI and a skill. Zero runtime dependencies

把 [Jev Search](https://github.com/superagents-lab/jev-search) 接進 Claude Code 和 Codex。裝成 Claude Code plugin 時，內建的 WebSearch 會直接由 Jev 回答，Jev 答不出來才退回內建；裝成 npm 套件時，是一個 MCP server 加 CLI，Claude Code、Codex 或任何能跑 shell 的 agent 都能用

Jev Search 的流程是：Jev 模型先讀懂你的一句話，決定要查哪些來源、哪段時間、用什麼關鍵字，再透過 Search1API 同時打 Google、DuckDuckGo、Yandex，必要時加上 Hacker News、Reddit、GitHub、X、arXiv、YouTube、Wikipedia、IMDb、WeChat，最後每一筆結果都由 Jev 打相關度分數。回來的是排好序的連結和摘要，不是生成的答案

這個 repo 同時是 npm 套件（`src/`）和 Claude Code plugin（`hooks/`、`.claude-plugin/`、`.mcp.json`、`skills/`），plugin 直接用套件裡的純函式，兩邊行為一致

## 安裝方式一：Claude Code plugin

這是給 Claude Code 使用者的建議路徑，裝完不用改任何指令或習慣，WebSearch 照常呼叫，答案換成 Jev 的

Function hooks 是 Claude Code 的 early access 功能，需要 2.1.271 以上，並且在 Claude Code 讀得到的地方開旗標，例如 `~/.claude/settings.json`：

```json
{ "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" } }
```

然後加入 [muki-ai-plugins](https://github.com/mukiwu/muki-ai-plugins) 這個 marketplace 並安裝，shell 或 session 裡的斜線指令都可以：

```sh
claude plugin marketplace add mukiwu/muki-ai-plugins
claude plugin install jev-search@muki-ai-plugins
```

安裝時會問三個設定：Jev Search 實例網址、要不要攔截 WebSearch、每次回幾筆，全部維持預設就是打官方的 jev.s1.dev。裝完重啟 Claude Code 或執行 `/reload-plugins`。不需要在 CLAUDE.md 寫任何東西，引導都由 plugin 自帶

之後你會得到：

- **模型知道 WebSearch 現在是 Jev**。plugin 會在對話開頭的 context 加一小段說明，跟 CLAUDE.md 同一層：一般網路問題先用 WebSearch，幾秒回來、一次跨多站；但問的是精確數字、排名、留言數這類站台資料，而站台又有正規 API 時，模型直接打 API 仍然是更好的選擇，plugin 不會擋
- **WebSearch 由 Jev 回答**。模型讀到的格式跟內建一樣，多一行 Answered by Jev Search 和帶相關度百分比的排序清單。搜完通知列會跳一行 Jev Search: N results via 哪些來源 in 幾秒。Jev 回錯誤、被限流、網路不通、或網域過濾後一筆都不剩，就自動退回內建 WebSearch，對話裡會留一行暗色提示
- **WebSearch