Tazio7/dsh-web-search-glm

dsh-zai-web-search

用于 DeepSeek Harness 的 ZAI GLM 网页搜索和抓取 MCP 插件。

该插件通过 MCP（模型上下文协议）服务器将 ZAI（智谱AI）的网页搜索和抓取能力集成到 DSH 中。

功能特性

- 网页搜索：使用 ZAI 的网页搜索 prime 服务搜索网页
- 网页抓取：使用 ZAI 的网页阅读器服务抓取并阅读网页内容
- 视觉 MCP：通过 MCP 访问 ZAI 的视觉能力
- 工具注册：自动向 DSH harness 注册工具以供模型使用
- 服务集成：提供用于编程访问的服务

安装

1. 将插件添加到你的 DSH 配置文件中：
dsh plugin --profile  add dsh-zai-web-search

2. 该插件将自动使用 ~/.dsh/.credentials.yaml 中的 DSH ZAI API 密钥。如果你已在 DSH 中配置了 ZAI，则无需额外设置。

配置

该插件通过你的配置文件目录中的 cordis.patch.yml 进行配置。主要配置选项：

- apiKey：你的 ZAI API 密钥（可通过环境变量 ZAI_API_KEY 设置）
- servers：MCP 服务器配置
- web-search-prime：网页搜索服务
- web-reader：网页内容抓取服务
- zai-vision：视觉能力服务
- registerTools：是否向 DSH harness 注册工具（默认：true）
- enabled：启用/禁用该插件（默认：true）

用法

作为工具

安装并配置后，以下工具将可供模型使用：

- web-search-prime/search：搜索网页
- web-reader/fetch：抓取网页内容
- zai-vision/*：与视觉相关的工具

作为服务

你也可以在你的 DSH 插件中以编程方式使用该服务：

import { Context } from '@deepseek-ai/cordis'

export default {
apply(ctx: Context) {
// 访问 ZAI Web Search 服务
const zaiWebSearch = ctx.get('zai-web-search')

if (zaiWebSearch) {
// 搜索网页
zaiWebSearch.searchWeb('your search query').then(results => {
console.log(results)
})

// 抓取网页内容
zaiWebSearch.fetchWeb('https://example.com').then(content => {
console.log(content)
})
}
}
}

环境变量

- ZAI_CODING_CN_API_KEY：用于身份验证的 ZAI API 密钥（如果在 DSH 中已配置则为可选）
- ZAI_API_KEY：ZAI API 密钥的备选环境变量
- ZAI_MODE：设置为 "ZHIPU" 以面向中国市场（默认）

MCP 服务器

该插件使用以下 MCP 服务器：

1. web-search-prime：来自 ZAI 的网页搜索服务
- URL：https://open.bigmodel.cn/api/mcp/web_search_prime/mcp
- 传输方式：HTTP Streamable

2. web-reader：网页内容抓取服务
- URL：https://open.bigmodel.cn/api/mcp/web_reader/mcp
- 传输方式：HTTP Streamable

3. zai-vision：视觉能力
- 命令：npx -y @z_ai/mcp-server@latest
- 传输方式：stdio

开发

构建该插件：

npm run build
要运行测试：

npm test

许可证

MIT