mcpField
智
智谱 Web Search MCP 工具(STDIO)

智谱 Web Search MCP 工具(STDIO)

ローカル
github.com/cr-zhichen検索971 週間前に更新

智谱 Web Search MCP 工具(STDIO) について

BigModel Web Search APIでウェブ検索を行うコマンドラインのMCPサーバーです。JSONの検索結果を読みやすいテキストに整形し、STDIOでクライアントと通信します。

主な機能

  1. 01BigModel Web Search APIの呼び出し
  2. 02JSON検索結果の整形
  3. 03STDIOによるMCPサーバー提供
  4. 04ドメインと期間の絞り込み

活用シーン

  1. 01MCPクライアントからウェブ検索
  2. 02ドメインや期間を指定した検索
  3. 03結果数と要約サイズの調整

MCP 対応

`web-search`ツールをMCPクライアントに提供し、クエリ、検索エンジン、件数、ドメイン、期間などを指定できます。STDIOで通信します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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-search

ツール

1

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
content_sizeenumいいえウェブページの要約の長さを制御します。 medium(デフォルト):バランスモード、約 400~600 文字。 high:コンテキストを最大化、約 2500 文字。 ユーザーが詳細な内容を明示的に求めない限り、デフォルト値を使用してください。medium | high
countintegerいいえ返す結果の件数。範囲は 1~50、デフォルトは 10 です。 対応する検索エンジン:search_pro_sogou、search_std、search_pro。 search_pro_sogou で選択できる値は 10、20、30、40、50 です。
querystringはい検索する内容です。query は 70 文字以内を推奨します
search_domain_filterstringいいえ検索結果を指定したドメインに限定します(例:'www.example.com')。 対応する検索エンジン:search_std、search_pro、search_pro_Jina。
search_engineenumいいえ呼び出す検索エンジンのコードです。現在、次に対応しています: 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_filterenumいいえ指定した期間内のウェブページを検索します。デフォルトは '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 工具

npm version

一个通过智谱 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 直接运行,无需全局安装。客户端会根据需要自动拉取并执行包。

  1. 找到你客户端的 mcp.json 配置文件(对于 Cursor,通常是 ~/.cursor/mcp.json)。

  2. 在该文件的 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 进行网页检索

参数:

参数名类型描述默认值
querystring搜索关键词,≤70字符必需
search_engineenum要调用的搜索引擎编码。search_std
countnumber返回条数 1~5010
search_domain_filterstring限定搜索结果的域名 (例如 'www.example.com')(可选)
search_recency_filterenum搜索指定时间范围内的网页。noLimit
content_sizeenum控制网页摘要的字数。medium

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。