智

智谱 Web Search MCP 工具（STDIO）

Name: 智谱 Web Search MCP 工具（STDIO）
Author: cr-zhichen

本地服务

github.com/cr-zhichen搜索与检索971 周前更新

代码仓库

关于智谱 Web Search MCP 工具（STDIO）

这是一个通过智谱 AI 开放平台 Web Search API 提供网页检索的 MCP 服务，以 STDIO 与客户端通信，并将 JSON 结果整理为易读文本。

主要功能

01调用智谱 Web Search API
02格式化 JSON 搜索结果
03通过 STDIO 提供 MCP 服务
04支持域名与时间筛选

适用场景

01在 MCP 客户端中检索网页
02限定搜索域名或时间范围
03调整结果数量与摘要长度

MCP 相关

作为 MCP 服务向客户端提供 `web-search` 工具，支持关键词、搜索引擎、结果数量、域名和时间范围等参数。通过 STDIO 通信。

#zhipu #web-search #mcp-tool

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cc-zhipu-web-search": {
      "command": "npx",
      "args": [
        "-y",
        "cc-zhipu-web-search"
      ],
      "env": {
        "BIGMODEL_API_KEY": "<BIGMODEL_API_KEY>"
      }
    }
  }
}

启动命令npx -y cc-zhipu-web-search

需要配置的环境变量

BIGMODEL_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcc-zhipu-web-searchstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
content_size	enum	否	控制网页摘要的字数。 medium (默认): 平衡模式, 约400-600字; high: 最大化上下文, 约2500字。除非用户特别要求详细内容, 否则使用默认值即可medium \| high
count	integer	否	返回结果的条数, 范围 1-50, 默认10。支持的搜索引擎：search_pro_sogou、search_std、search_pro。对于 search_pro_sogou，可选值为 10, 20, 30, 40, 50。
query	string	是	需要进行搜索的内容, 建议搜索 query 不超过 70 个字符
search_domain_filter	string	否	限定搜索结果的域名 (例如 'www.example.com')。支持的搜索引擎：search_std、search_pro、search_pro_Jina。
search_engine	enum	否	要调用的搜索引擎编码。目前支持： search_std (智谱基础版), search_pro (智谱高阶版), search_pro_sogou (搜狗), search_pro_quark (夸克搜索), search_pro_jina (jina.ai搜索), search_pro_bing (必应搜索)search_std \| search_pro \| search_pro_sogou \| search_pro_quark \| search_pro_jina \| search_pro_bing
search_recency_filter	enum	否	搜索指定时间范围内的网页。默认为 'noLimit'。可选值为 'oneDay'、'oneWeek'、'oneMonth'、'oneYear'、'noLimit'。支持的搜索引擎：search_std、search_pro、search_pro_Sogou、search_pro_quark。oneDay \| oneWeek \| oneMonth \| oneYear \| noLimit

详细介绍

来自项目 README

智谱 Web Search MCP 工具

一个通过智谱 AI 开放平台（BigModel）的 Web Search API 提供网页搜索能力的命令行工具，并符合 Model-Code-Protocol (MCP) 规范。

这允许任何支持 MCP 的客户端（例如 AI 智能体）调用此工具来获得网页搜索的能力。

✨ 功能

调用智谱搜索 API：将参数转换并调用智谱 Web Search API。
结果格式化：将返回的 JSON 结果格式化为对人类或模型易读的文本格式。
MCP 服务：作为一个 MCP 服务器运行，可以通过标准输入/输出（STDIO）与客户端通信。

📦 安装与使用

⚙️ 配置

在使用前，你需要一个智谱 AI 的 API Key。你可以在智谱 AI 开放平台上获取。

与 MCP 客户端集成

对于支持 MCP 的客户端可使用 npx 直接运行，无需全局安装。客户端会根据需要自动拉取并执行包。

找到你客户端的 mcp.json 配置文件（对于 Cursor，通常是 ~/.cursor/mcp.json）。

在该文件的 mcpServers 对象中，添加以下条目：

{
  "mcpServers": {
    "zhipu-web-search": {
      "command": "npx",
      "args": [
        "cc-zhipu-web-search"
      ],
      "env": {
        "BIGMODEL_API_KEY": "YOUR_BIGMODEL_API_KEY"
      }
    }
  }
}

如果你已经有其他服务器，只需在 mcpServers 中添加 "zhipu-web-search": { ... } 即可。

🛠️ 作为 MCP 工具使用

本工具提供了一个名为 web-search 的工具，可供 MCP 客户端调用。

工具描述: 使用智谱 Web Search API 进行网页检索

参数:

参数名	类型	描述	默认值
`query`	`string`	搜索关键词，≤70字符	必需
`search_engine`	`enum`	要调用的搜索引擎编码。	`search_std`
`count`	`number`	返回条数 1~50	`10`
`search_domain_filter`	`string`	限定搜索结果的域名 (例如 'www.example.com')	(可选)
`search_recency_filter`	`enum`	搜索指定时间范围内的网页。	`noLimit`
`content_size`	`enum`	控制网页摘要的字数。	`medium`