dsh-search-mcp
将内置搜索替换为第三方搜索MCP服务器 适合需要使用Tavily、Brave等专业搜索服务替代默认搜索的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:gxpppp/dsh-search-mcp说明文档
阅读完整 README ↗配置
打开:
设置 → 插件 → 插件配置 → 搜索 MCP
已知 provider
- 点击 Tavily、Brave、Exa、Perplexity 或 DuckDuckGo 快捷按钮。
- 展开服务器行。
- 对需要凭据的 provider 填写 CDKey/API key,然后保存。
- DuckDuckGo 无需 key。
已知 provider 的 endpoint、transport、鉴权方式、工具名和结果参数由 Host catalog 固定管理,设置页不会自动填入或显示链接。保存 CDKey 后,客户端先调用 credentials.set,再将生成的 credential reference 写入服务器设置;密钥本身不会写回普通 settings 字段。
也可以预先在 $DSH_HOME/.credentials.yaml 中保存凭据,再在设置页填写引用名:
TAVILY_API_KEY:
EXA_API_KEY:
PERPLEXITY_API_KEY:
BRAVE_API_KEY:
RC2 的 credentials/reference-updated 事件会刷新设置卡片中的“已配置/未配置”状态,但不会传输密钥值。卡片按 RC2 每批最多 64 个引用的限制分批读取状态。保存多个字段失败时会逆序恢复已写入的 settings,并清理本次新建的 credential reference;由于 RC2 不允许读回已有密钥,覆盖一个此前已配置的引用后无法跨 credentials/settings 做值级回滚。
自定义 MCP
添加 custom 服务器后,可配置:
| 字段 | 说明 |
|---|---|
id | 服务器唯一标识,供 defaultServer 引用 |
transport | http(Streamable HTTP)或 stdio |
url | 仅 HTTP 自定义 MCP 使用 |
command / args | 仅 stdio 自定义 MCP 使用 |
apiKey | 写入方向的 CDKey/API key 输入 |
apiKeyEnv | 环境变量或 DSH credential reference |
authStyle | HTTP 的 query 或 header |
authParam | query/header 参数名;stdio 下作为环境变量名 |
toolName | MCP 搜索工具名称 |
maxResults | 单服务器结果数覆盖 |
全局选项
| 字段 | 说明 |
|---|---|
defaultServer | 默认服务器 id;留空时使用第一行 |
maxResults | 全局结果数上限,默认 8,可选 1–50 |
searchTimeoutMs | 每次 MCP 搜索超时,默认 30000 ms;界面以秒显示 |