智谱三件套 youbuwei/dsh-zhipu-mcp

dsh-zhipu-mcp

智谱 BigModel 专属 MCP 的 DeepSeek Harness（DSH）独立插件：联网搜索 + 网页读取 + 开源仓库，一个插件装齐智谱 GLM Coding Plan 的三件套远程 MCP，无需本地安装任何服务。

Zhipu BigModel MCP (web search / web reader / GitHub repo reader) as a standalone DeepSeek Harness plugin. Requires a GLM Coding Plan API key.

| 服务器 | 模型可用工具 | 能力 |
| web-search-prime | mcp__web-search-prime__webSearchPrime | 全网搜索：新闻 / 股价 / 天气等实时信息 |
| web-reader | mcp__web-reader__webReader | 抓取任意网页的标题 / 正文 / 元数据 / 链接 |
| zread | mcp__zread__search_doc mcp__zread__get_repo_structure mcp__zread__read_file | GitHub 开源仓库：文档检索 / 目录结构 / 源码读取 |

前置条件

- DeepSeek Harness（Desktop 或 dsh web 均可）
- 智谱 GLM Coding Plan 套餐的 API Key（三件套是 Coding Plan 专属 MCP，普通 API Key 不通用）

安装

方式一：npm（推荐）

dsh plugin --profile web add dsh-zhipu-mcp@latest
Desktop 用户把 --profile web 换成 --profile desktop，或在 Desktop 插件管理器中搜索安装

方式二：从 GitHub 安装

dsh plugin --profile web add git+https://github.com/youbuwei/dsh-zhipu-mcp.git

方式三：手动挂载（Desktop）

把仓库克隆到任意位置，在 profile 的 cordis.patch.yml 中加入：

- insert:
- id: zhipu-mcp
name: /path/to/dsh-zhipu-mcp/index.js
config:
apiKeyRef: ZAI_CODING_CN_API_KEY

安装后重启 DSH 生效；可用 dsh --profile --dump-config | grep zhipu 确认挂载。

API Key 配置

解析顺序（前面的优先）：

1. 插件配置 apiKey —— 直接填写；
2. DSH 凭据服务中 apiKeyRef（默认 ZAI_CODING_CN_API_KEY）引用的 Key —— 如果你正在用 GLM Coding Plan 跑模型，默认零配置，直接复用当前 Key；
3. 环境变量 ZAI_CODING_CN_API_KEY。

本插件不保存任何密钥。

配置项

| 字段 | 默认值 | 说明 |
| apiKey | 空 | 直接指定智谱 API Key（一般留空） |
| apiKeyRef | ZAI_CODING_CN_API_KEY | 凭据服务 / 环境变量中的 Key 引用名 |

卸载

dsh plugin --profile web remove dsh-zhipu-mcp

或删除对应补丁条目，重启 DSH。

实现说明

- 通过运行中 DSH 自带的 @deepseek-ai/dsh-mcp-client 桥接（版本与宿主严格一致），每台服务器挂载一个子插件实例；工具名由 serverName + 原始工具名组成，升级后保持稳定。
- DSH 安装目录定位顺序：环境变量 DSH_APP_ROOT → macOS /Applications（或 ~/Applications）→ Windows %LOCALAPPDATA%\Programs\DSH Desktop → 裸名导入（已把 @deepseek-ai/dsh-mcp-client 安装为可解析依赖的 profile）。
- 子实例 failOnStartupError: false：网络异常时 DSH 照常启动，仅该服务器工具暂不可用并自动重连。
- Config schema 使用宿主自带 schemastery，可在设置界面直接编辑。

Standalone DeepSeek Harness plugin that bridges Zhipu's three official remote MCP servers (web search / web reader / GitHub repo reader) for GLM Coding Plan subscribers. Key resolution: plugin apiKey → DSH credential store ref (ZAI_CODING_CN_API_KEY by default, reusing the key your GLM model already uses) → environment variable. See the tables above for tools and config; install via dsh plugin add, restart DSH, done.

License

MIT