智谱 Web Search MCP 工具(STDIO) について
BigModel Web Search APIでウェブ検索を行うコマンドラインのMCPサーバーです。JSONの検索結果を読みやすいテキストに整形し、STDIOでクライアントと通信します。
主な機能
- 01BigModel Web Search APIの呼び出し
- 02JSON検索結果の整形
- 03STDIOによるMCPサーバー提供
- 04ドメインと期間の絞り込み
活用シーン
- 01MCPクライアントからウェブ検索
- 02ドメインや期間を指定した検索
- 03結果数と要約サイズの調整
MCP 対応
`web-search`ツールをMCPクライアントに提供し、クエリ、検索エンジン、件数、ドメイン、期間などを指定できます。STDIOで通信します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 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(Zhipu ベーシック版)、 search_pro(Zhipu 上級版)、 search_pro_sogou(Sogou)、 search_pro_quark(Quark Search)、 search_pro_jina(jina.ai Search)、 search_pro_bing(Bing Search)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 |
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。