@yyaylt/zhipu-web-search-mcp-server 1.0.4 → 1.0.5

package/README.md

@@ -67,12 +67,20 @@ opencode mcp add zhipu-web-search -- node D:\path\to\zhipu-web-search-mcp-server
 | search_query | string | 必填 | 搜索内容，不超过 70 字符 |
 | search_engine | string | search_std | 搜索引擎：search_std / search_pro / search_pro_sogou / search_pro_quark |
 | search_intent | boolean | false | 是否执行搜索意图识别 |
-| count | number | 10 | 返回结果条数，1-50 |
+| count | number | 支持的引擎默认 10 | search_std / search_pro：1-50 的整数；search_pro_sogou：仅 10/20/30/40/50；search_pro_quark：不支持，不能指定 |
 | search_domain_filter | string | - | 白名单域名过滤（search_std / search_pro / search_pro_sogou 支持） |
 | search_recency_filter | string | noLimit | 时间过滤：oneDay / oneWeek / oneMonth / oneYear / noLimit |
 | content_size | string | medium | 内容长短：medium / high |
 | user_id | string | - | 终端用户 ID，6-128 字符 |
 
+条数行为依据 [Web Search API 官方参数文档](https://docs.bigmodel.cn/api-reference/工具-api/网络搜索)：
+
+- `count` 是请求条数，输出 JSON 的 `count` 是实际收到的 `results.length`，不能将两者视为必然相等。
+- 官网在搜狗枚举说明后注明同时指定 `search_domain_filter` 和 `search_recency_filter` 时 `count` 不生效，未明确此备注对其他引擎的适用范围。项目保留用户的具体过滤条件并提示此限制。
+- `search_recency_filter` 为 `noLimit` 时省略该请求字段，避免默认值导致同时携带域名和时间过滤；官网未明确服务端是否将显式 `noLimit` 计入上述限制。
+- 夸克不发送 `count`；显式指定会返回参数错误。搜狗的非法条数也会在发送请求前拒绝。
+- Markdown 按约 25,000 字符的条目预算截断，截断标题显示“展示 X 条，共 Y 条”；结构化结果始终保留完整列表，文本同时说明请求与实际返回数量。
+
 ## 隐私与安全提示
 
 - `ZHIPU_API_KEY` 仅通过环境变量注入，请勿将其写入代码、配置仓库或提交到 Git 历史。
@@ -118,4 +126,4 @@ It includes third-party packages with the following licenses (updated at build t
 - BSD-3-Clause (2 packages)
 - BSD-2-Clause (1 package)
 
-> 提示：以上数量为生成本文档时的快照。依赖升级后可用 `npx license-checker --summary` 重新生成核对。
+> 提示：以上数量为生成本文档时的快照。依赖升级后可用 `npx license-checker --summary` 重新生成核对。

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,oDAAoD,CAAC;AAG9E,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAGX,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAIpD,CAAC;AAGF,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,oDAAoD,CAAC;AAG9E,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAGX,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAEpD,CAAC;AAGF,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/dist/constants.js

@@ -24,10 +24,8 @@ export const CONTENT_SIZES = {
     MEDIUM: "medium",
     HIGH: "high"
 };
-// 各搜索引擎支持的 count 枚举约束
+// 仅搜狗限制为枚举；基础版和高阶版支持 1-50 的整数。
 export const COUNT_BY_ENGINE = {
-    [SEARCH_ENGINES.STORE]: [10, 20, 30, 40, 50],
-    [SEARCH_ENGINES.PRO]: [10, 20, 30, 40, 50],
     [SEARCH_ENGINES.PRO_SOGOU]: [10, 20, 30, 40, 50]
 };
 // 请求超时时间（毫秒）

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2BAA2B;AAE3B,mBAAmB;AACnB,MAAM,CAAC,MAAM,YAAY,GAAG,iDAAiD,CAAC;AAE9E,wBAAwB;AACxB,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,YAAY;IACnB,GAAG,EAAE,YAAY;IACjB,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAEX,YAAY;AACZ,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,SAAS;AACT,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX,sBAAsB;AACtB,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;CACjD,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2BAA2B;AAE3B,mBAAmB;AACnB,MAAM,CAAC,MAAM,YAAY,GAAG,iDAAiD,CAAC;AAE9E,wBAAwB;AACxB,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,YAAY;IACnB,GAAG,EAAE,YAAY;IACjB,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAEX,YAAY;AACZ,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,SAAS;AACT,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX,+BAA+B;AAC/B,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;CACjD,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC"}

package/dist/index.d.ts

@@ -8,7 +8,9 @@
  * 环境变量：
  *   ZHIPU_API_KEY - 智谱 API Key（必填），从 https://bigmodel.cn/usercenter/proj-mgmt/apikeys 获取
  */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { WebSearchToolOutput } from "./types.js";
+export declare const server: McpServer;
 export declare function formatResultsMarkdown(output: WebSearchToolOutput, charLimit?: number): {
     text: string;
     truncated: boolean;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAatD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAkDtC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,eAAO,MAAM,MAAM,WAGjB,CAAC;AAMH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAwDtC"}

package/dist/index.js

@@ -12,11 +12,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { callWebSearch, handleApiError } from "./services/webSearchApi.js";
-import { WebSearchInputSchema } from "./schemas/webSearch.js";
+import { WebSearchInputSchema, WebSearchRequestSchema } from "./schemas/webSearch.js";
 import { CHARACTER_LIMIT } from "./constants.js";
 import { pathToFileURL } from "node:url";
 // 创建 MCP 服务器实例
-const server = new McpServer({
+export const server = new McpServer({
     name: "zhipu-web-search-mcp-server",
     version: "1.0.0"
 });
@@ -40,9 +40,11 @@ export function formatResultsMarkdown(output, charLimit) {
     if (output.results.length === 0) {
         return { text: "未找到相关搜索结果。", truncated: false };
     }
-    lines.push(`# 搜索结果 (${output.count})`);
+    const headingIndex = lines.length;
+    lines.push(`# 搜索结果 (${output.results.length})`);
     lines.push("");
     let truncated = false;
+    let displayedCount = 0;
     for (let index = 0; index < output.results.length; index++) {
         const item = output.results[index];
         const itemLines = [`## ${index + 1}. ${item.title}`];
@@ -66,6 +68,10 @@ export function formatResultsMarkdown(output, charLimit) {
         }
         lines.push(itemText);
         charCount += itemText.length + 1;
+        displayedCount++;
+    }
+    if (truncated) {
+        lines[headingIndex] = `# 搜索结果（展示 ${displayedCount} 条，共 ${output.results.length} 条）`;
     }
     return { text: lines.join("\n"), truncated };
 }
@@ -80,7 +86,7 @@ Args:
   - search_query (string): 需要搜索的内容，建议不超过 70 个字符
   - search_engine (string): 搜索引擎编码（默认 search_std）
   - search_intent (boolean): 是否执行搜索意图识别（默认 false）
-  - count (number): 返回结果条数，1-50（默认 10）
+  - count (number): 请求条数，search_std/search_pro 支持 1-50，搜狗仅支持 10/20/30/40/50（默认 10）；夸克不支持，请勿指定。官网注明同时指定域名和时间过滤时 count 不生效
   - search_domain_filter (string): 白名单域名过滤，仅返回指定域名内容（可选）
   - search_recency_filter (string): 时间范围过滤：oneDay/oneWeek/oneMonth/oneYear/noLimit（默认 noLimit）
   - content_size (string): 返回内容长短：medium/high（默认 medium）
@@ -88,7 +94,7 @@ Args:
 
 Returns:
   Markdown 文本：搜索意图识别结果 + 搜索结果列表（标题、发布时间、来源、链接、摘要）
-  同时返回结构化 JSON 数据。
+  同时返回完整结构化 JSON 数据，count 表示实际返回条数；Markdown 超长时显示展示条数和总条数。
 
 Examples:
   - "帮我搜索今天的天气" -> search_query="今天北京天气"
@@ -107,6 +113,13 @@ Error Handling:
         openWorldHint: true
     }
 }, async (params) => {
+    const request = WebSearchRequestSchema.safeParse(params);
+    if (!request.success) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: request.error.issues.map((issue) => issue.message).join("\n") }]
+        };
+    }
     const apiKey = process.env.ZHIPU_API_KEY;
     if (!apiKey) {
         return {
@@ -120,18 +133,7 @@ Error Handling:
         };
     }
     try {
-        const data = await callWebSearch(apiKey, {
-            search_query: params.search_query,
-            search_engine: params.search_engine,
-            search_intent: params.search_intent,
-            count: params.count,
-            ...(params.search_domain_filter
-                ? { search_domain_filter: params.search_domain_filter }
-                : {}),
-            search_recency_filter: params.search_recency_filter,
-            content_size: params.content_size,
-            ...(params.user_id ? { user_id: params.user_id } : {})
-        });
+        const data = await callWebSearch(apiKey, request.data);
         const results = data.search_result ?? [];
         const output = {
             id: data.id,
@@ -143,9 +145,17 @@ Error Handling:
         };
         // 一次性限长构建 Markdown，超限即截断，避免先构建完整文本再二次格式化的内存峰值
         const { text, truncated } = formatResultsMarkdown(output, CHARACTER_LIMIT);
-        const finalText = truncated
-            ? `${text}\n\n> 响应因过长被截断（原 ${results.length} 条），可减少 count 或增加关键词精度以查看更多结果。`
-            : text;
+        const notes = [];
+        if (request.data.count !== undefined) {
+            notes.push(`请求 ${request.data.count} 条，实际返回 ${results.length} 条。`);
+        }
+        if (request.data.count !== undefined && request.data.search_domain_filter && request.data.search_recency_filter) {
+            notes.push("官网注明同时指定域名和时间过滤时 count 不生效；请以实际返回条数为准。");
+        }
+        if (truncated) {
+            notes.push(`文本因过长被截断，完整 ${results.length} 条结果保留在 structuredContent.results 中。`);
+        }
+        const finalText = notes.length ? `${text}\n\n> ${notes.join("\n> ")}` : text;
         return {
             content: [{ type: "text", text: finalText }],
             structuredContent: output

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/schemas/webSearch.d.ts

@@ -8,7 +8,7 @@ export declare const WebSearchInputSchema: z.ZodObject<{
         readonly PRO_QUARK: "search_pro_quark";
     }>>;
     search_intent: z.ZodDefault<z.ZodBoolean>;
-    count: z.ZodDefault<z.ZodNumber>;
+    count: z.ZodOptional<z.ZodNumber>;
     search_domain_filter: z.ZodOptional<z.ZodString>;
     search_recency_filter: z.ZodDefault<z.ZodNativeEnum<{
         readonly ONE_DAY: "oneDay";
@@ -26,9 +26,9 @@ export declare const WebSearchInputSchema: z.ZodObject<{
     search_query: string;
     search_engine: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark";
     search_intent: boolean;
-    count: number;
     search_recency_filter: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit";
     content_size: "medium" | "high";
+    count?: number | undefined;
     search_domain_filter?: string | undefined;
     user_id?: string | undefined;
 }, {
@@ -42,4 +42,82 @@ export declare const WebSearchInputSchema: z.ZodObject<{
     user_id?: string | undefined;
 }>;
 export type WebSearchInput = z.infer<typeof WebSearchInputSchema>;
+export declare const WebSearchRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    search_query: z.ZodString;
+    search_engine: z.ZodDefault<z.ZodNativeEnum<{
+        readonly STORE: "search_std";
+        readonly PRO: "search_pro";
+        readonly PRO_SOGOU: "search_pro_sogou";
+        readonly PRO_QUARK: "search_pro_quark";
+    }>>;
+    search_intent: z.ZodDefault<z.ZodBoolean>;
+    count: z.ZodOptional<z.ZodNumber>;
+    search_domain_filter: z.ZodOptional<z.ZodString>;
+    search_recency_filter: z.ZodDefault<z.ZodNativeEnum<{
+        readonly ONE_DAY: "oneDay";
+        readonly ONE_WEEK: "oneWeek";
+        readonly ONE_MONTH: "oneMonth";
+        readonly ONE_YEAR: "oneYear";
+        readonly NO_LIMIT: "noLimit";
+    }>>;
+    content_size: z.ZodDefault<z.ZodNativeEnum<{
+        readonly MEDIUM: "medium";
+        readonly HIGH: "high";
+    }>>;
+    user_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    search_query: string;
+    search_engine: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark";
+    search_intent: boolean;
+    search_recency_filter: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit";
+    content_size: "medium" | "high";
+    count?: number | undefined;
+    search_domain_filter?: string | undefined;
+    user_id?: string | undefined;
+}, {
+    search_query: string;
+    search_engine?: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark" | undefined;
+    search_intent?: boolean | undefined;
+    count?: number | undefined;
+    search_domain_filter?: string | undefined;
+    search_recency_filter?: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit" | undefined;
+    content_size?: "medium" | "high" | undefined;
+    user_id?: string | undefined;
+}>, {
+    search_query: string;
+    search_engine: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark";
+    search_intent: boolean;
+    search_recency_filter: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit";
+    content_size: "medium" | "high";
+    count?: number | undefined;
+    search_domain_filter?: string | undefined;
+    user_id?: string | undefined;
+}, {
+    search_query: string;
+    search_engine?: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark" | undefined;
+    search_intent?: boolean | undefined;
+    count?: number | undefined;
+    search_domain_filter?: string | undefined;
+    search_recency_filter?: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit" | undefined;
+    content_size?: "medium" | "high" | undefined;
+    user_id?: string | undefined;
+}>, {
+    search_recency_filter?: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | undefined;
+    search_domain_filter?: string | undefined;
+    count?: number | undefined;
+    search_query: string;
+    search_engine: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark";
+    search_intent: boolean;
+    content_size: "medium" | "high";
+    user_id?: string | undefined;
+}, {
+    search_query: string;
+    search_engine?: "search_std" | "search_pro" | "search_pro_sogou" | "search_pro_quark" | undefined;
+    search_intent?: boolean | undefined;
+    count?: number | undefined;
+    search_domain_filter?: string | undefined;
+    search_recency_filter?: "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | "noLimit" | undefined;
+    content_size?: "medium" | "high" | undefined;
+    user_id?: string | undefined;
+}>;
 //# sourceMappingURL=webSearch.d.ts.map

package/dist/schemas/webSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/schemas/webSearch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/schemas/webSearch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchC,CAAC"}

package/dist/schemas/webSearch.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 // Web Search 工具的 Zod 输入校验 schema
 import { z } from "zod";
-import { SEARCH_ENGINES, RECENCY_FILTERS, CONTENT_SIZES } from "../constants.js";
+import { SEARCH_ENGINES, RECENCY_FILTERS, CONTENT_SIZES, COUNT_BY_ENGINE } from "../constants.js";
 export const WebSearchInputSchema = z
     .object({
     search_query: z
@@ -22,8 +22,8 @@ export const WebSearchInputSchema = z
         .int()
         .min(1)
         .max(50)
-        .default(10)
-        .describe("返回结果的条数，范围 1-50。注意：search_pro_sogou 仅支持枚举值 10/20/30/40/50，且同时指定 search_domain_filter 和 search_recency_filter 时 count 不生效"),
+        .optional()
+        .describe("请求结果条数：search_std、search_pro 支持 1-50，默认 10；search_pro_sogou 仅支持 10/20/30/40/50，默认 10；search_pro_quark 不支持，请勿指定。官网注明同时指定域名和时间过滤时 count 不生效，实际条数以返回结果为准"),
     search_domain_filter: z
         .string()
         .optional()
@@ -44,4 +44,21 @@ export const WebSearchInputSchema = z
         .describe("终端用户的唯一 ID，用于平台对非法活动的干预，长度 6-128 个字符")
 })
     .strict();
+// 保留工具输入为普通对象 schema，避免跨字段校验影响 MCP 的 JSON Schema 展示。
+// 请求前单独校验：count 不提前填默认值，才能区分夸克的省略与显式指定。
+export const WebSearchRequestSchema = WebSearchInputSchema.superRefine((params, ctx) => {
+    if (params.search_engine === SEARCH_ENGINES.PRO_QUARK && params.count !== undefined) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["count"], message: "search_pro_quark 不支持 count，请移除此参数。" });
+    }
+    const counts = COUNT_BY_ENGINE[params.search_engine];
+    if (counts && !counts.includes(params.count ?? 10)) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["count"], message: "search_pro_sogou 的 count 仅支持 10/20/30/40/50。" });
+    }
+}).transform(({ count, search_recency_filter, search_domain_filter, ...params }) => ({
+    ...params,
+    ...(params.search_engine === SEARCH_ENGINES.PRO_QUARK ? {} : { count: count ?? 10 }),
+    ...(search_domain_filter ? { search_domain_filter } : {}),
+    // noLimit 与省略均表示不限时间；省略可避免无意中同时指定域名和时间字段。
+    ...(search_recency_filter === RECENCY_FILTERS.NO_LIMIT ? {} : { search_recency_filter })
+}));
 //# sourceMappingURL=webSearch.js.map

package/dist/schemas/webSearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"webSearch.js","sourceRoot":"","sources":["../../src/schemas/webSearch.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,iCAAiC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,EAAE,kBAAkB,CAAC;SAC3B,QAAQ,CAAC,sBAAsB,CAAC;IAEnC,aAAa,EAAE,CAAC;SACb,UAAU,CAAC,cAAc,CAAC;SAC1B,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;SAC7B,QAAQ,CACP,4FAA4F,CAC7F;IAEH,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,8CAA8C,CAC/C;IAEH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,0HAA0H,CAC3H;IAEH,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E,CAChF;IAEH,qBAAqB,EAAE,CAAC;SACrB,UAAU,CAAC,eAAe,CAAC;SAC3B,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC;SACjC,QAAQ,CACP,sFAAsF,CACvF;IAEH,YAAY,EAAE,CAAC;SACZ,UAAU,CAAC,aAAa,CAAC;SACzB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;SAC7B,QAAQ,CACP,6DAA6D,CAC9D;IAEH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"webSearch.js","sourceRoot":"","sources":["../../src/schemas/webSearch.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,iCAAiC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,EAAE,kBAAkB,CAAC;SAC3B,QAAQ,CAAC,sBAAsB,CAAC;IAEnC,aAAa,EAAE,CAAC;SACb,UAAU,CAAC,cAAc,CAAC;SAC1B,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;SAC7B,QAAQ,CACP,4FAA4F,CAC7F;IAEH,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,8CAA8C,CAC/C;IAEH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,uJAAuJ,CACxJ;IAEH,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E,CAChF;IAEH,qBAAqB,EAAE,CAAC;SACrB,UAAU,CAAC,eAAe,CAAC;SAC3B,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC;SACjC,QAAQ,CACP,sFAAsF,CACvF;IAEH,YAAY,EAAE,CAAC;SACZ,UAAU,CAAC,aAAa,CAAC;SACzB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;SAC7B,QAAQ,CACP,6DAA6D,CAC9D;IAEH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,qDAAqD;AACrD,wCAAwC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IACrF,IAAI,MAAM,CAAC,aAAa,KAAK,cAAc,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACpF,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC;IAC1H,CAAC;AACH,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACnF,GAAG,MAAM;IACT,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;IACpF,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,0CAA0C;IAC1C,GAAG,CAAC,qBAAqB,KAAK,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACzF,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yyaylt/zhipu-web-search-mcp-server",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "MCP server for ZHIPU AI Web Search API integration",
   "keywords": [
     "zhipu",
@@ -57,4 +57,4 @@
     "LICENSE",
     "package.json"
   ]
-}
+}

package/src/constants.ts

@@ -30,10 +30,8 @@ export const CONTENT_SIZES = {
   HIGH: "high"
 } as const;
 
-// 各搜索引擎支持的 count 枚举约束
+// 仅搜狗限制为枚举；基础版和高阶版支持 1-50 的整数。
 export const COUNT_BY_ENGINE: Record<string, number[]> = {
-  [SEARCH_ENGINES.STORE]: [10, 20, 30, 40, 50],
-  [SEARCH_ENGINES.PRO]: [10, 20, 30, 40, 50],
   [SEARCH_ENGINES.PRO_SOGOU]: [10, 20, 30, 40, 50]
 };
 

package/src/index.ts

@@ -13,13 +13,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { callWebSearch, handleApiError } from "./services/webSearchApi.js";
-import { WebSearchInputSchema } from "./schemas/webSearch.js";
+import { WebSearchInputSchema, WebSearchRequestSchema } from "./schemas/webSearch.js";
 import { CHARACTER_LIMIT } from "./constants.js";
 import type { WebSearchToolOutput } from "./types.js";
 import { pathToFileURL } from "node:url";
 
 // 创建 MCP 服务器实例
-const server = new McpServer({
+export const server = new McpServer({
   name: "zhipu-web-search-mcp-server",
   version: "1.0.0"
 });
@@ -50,10 +50,12 @@ export function formatResultsMarkdown(
     return { text: "未找到相关搜索结果。", truncated: false };
   }
 
-  lines.push(`# 搜索结果 (${output.count})`);
+  const headingIndex = lines.length;
+  lines.push(`# 搜索结果 (${output.results.length})`);
   lines.push("");
 
   let truncated = false;
+  let displayedCount = 0;
   for (let index = 0; index < output.results.length; index++) {
     const item = output.results[index];
     const itemLines = [`## ${index + 1}. ${item.title}`];
@@ -78,8 +80,12 @@ export function formatResultsMarkdown(
     }
     lines.push(itemText);
     charCount += itemText.length + 1;
+    displayedCount++;
   }
 
+  if (truncated) {
+    lines[headingIndex] = `# 搜索结果（展示 ${displayedCount} 条，共 ${output.results.length} 条）`;
+  }
   return { text: lines.join("\n"), truncated };
 }
 
@@ -96,7 +102,7 @@ Args:
   - search_query (string): 需要搜索的内容，建议不超过 70 个字符
   - search_engine (string): 搜索引擎编码（默认 search_std）
   - search_intent (boolean): 是否执行搜索意图识别（默认 false）
-  - count (number): 返回结果条数，1-50（默认 10）
+  - count (number): 请求条数，search_std/search_pro 支持 1-50，搜狗仅支持 10/20/30/40/50（默认 10）；夸克不支持，请勿指定。官网注明同时指定域名和时间过滤时 count 不生效
   - search_domain_filter (string): 白名单域名过滤，仅返回指定域名内容（可选）
   - search_recency_filter (string): 时间范围过滤：oneDay/oneWeek/oneMonth/oneYear/noLimit（默认 noLimit）
   - content_size (string): 返回内容长短：medium/high（默认 medium）
@@ -104,7 +110,7 @@ Args:
 
 Returns:
   Markdown 文本：搜索意图识别结果 + 搜索结果列表（标题、发布时间、来源、链接、摘要）
-  同时返回结构化 JSON 数据。
+  同时返回完整结构化 JSON 数据，count 表示实际返回条数；Markdown 超长时显示展示条数和总条数。
 
 Examples:
   - "帮我搜索今天的天气" -> search_query="今天北京天气"
@@ -124,6 +130,13 @@ Error Handling:
     }
   },
   async (params) => {
+    const request = WebSearchRequestSchema.safeParse(params);
+    if (!request.success) {
+      return {
+        isError: true,
+        content: [{ type: "text" as const, text: request.error.issues.map((issue) => issue.message).join("\n") }]
+      };
+    }
     const apiKey = process.env.ZHIPU_API_KEY;
     if (!apiKey) {
       return {
@@ -138,18 +151,7 @@ Error Handling:
     }
 
     try {
-      const data = await callWebSearch(apiKey, {
-        search_query: params.search_query,
-        search_engine: params.search_engine,
-        search_intent: params.search_intent,
-        count: params.count,
-        ...(params.search_domain_filter
-          ? { search_domain_filter: params.search_domain_filter }
-          : {}),
-        search_recency_filter: params.search_recency_filter,
-        content_size: params.content_size,
-        ...(params.user_id ? { user_id: params.user_id } : {})
-      });
+      const data = await callWebSearch(apiKey, request.data);
 
       const results = data.search_result ?? [];
       const output: WebSearchToolOutput = {
@@ -163,9 +165,17 @@ Error Handling:
 
       // 一次性限长构建 Markdown，超限即截断，避免先构建完整文本再二次格式化的内存峰值
       const { text, truncated } = formatResultsMarkdown(output, CHARACTER_LIMIT);
-      const finalText = truncated
-        ? `${text}\n\n> 响应因过长被截断（原 ${results.length} 条），可减少 count 或增加关键词精度以查看更多结果。`
-        : text;
+      const notes: string[] = [];
+      if (request.data.count !== undefined) {
+        notes.push(`请求 ${request.data.count} 条，实际返回 ${results.length} 条。`);
+      }
+      if (request.data.count !== undefined && request.data.search_domain_filter && request.data.search_recency_filter) {
+        notes.push("官网注明同时指定域名和时间过滤时 count 不生效；请以实际返回条数为准。");
+      }
+      if (truncated) {
+        notes.push(`文本因过长被截断，完整 ${results.length} 条结果保留在 structuredContent.results 中。`);
+      }
+      const finalText = notes.length ? `${text}\n\n> ${notes.join("\n> ")}` : text;
 
       return {
         content: [{ type: "text" as const, text: finalText }],

package/src/schemas/webSearch.ts

@@ -5,7 +5,8 @@ import { z } from "zod";
 import {
   SEARCH_ENGINES,
   RECENCY_FILTERS,
-  CONTENT_SIZES
+  CONTENT_SIZES,
+  COUNT_BY_ENGINE
 } from "../constants.js";
 
 export const WebSearchInputSchema = z
@@ -35,9 +36,9 @@ export const WebSearchInputSchema = z
       .int()
       .min(1)
       .max(50)
-      .default(10)
+      .optional()
       .describe(
-        "返回结果的条数，范围 1-50。注意：search_pro_sogou 仅支持枚举值 10/20/30/40/50，且同时指定 search_domain_filter 和 search_recency_filter 时 count 不生效"
+        "请求结果条数：search_std、search_pro 支持 1-50，默认 10；search_pro_sogou 仅支持 10/20/30/40/50，默认 10；search_pro_quark 不支持，请勿指定。官网注明同时指定域名和时间过滤时 count 不生效，实际条数以返回结果为准"
       ),
 
     search_domain_filter: z
@@ -71,3 +72,21 @@ export const WebSearchInputSchema = z
   .strict();
 
 export type WebSearchInput = z.infer<typeof WebSearchInputSchema>;
+
+// 保留工具输入为普通对象 schema，避免跨字段校验影响 MCP 的 JSON Schema 展示。
+// 请求前单独校验：count 不提前填默认值，才能区分夸克的省略与显式指定。
+export const WebSearchRequestSchema = WebSearchInputSchema.superRefine((params, ctx) => {
+  if (params.search_engine === SEARCH_ENGINES.PRO_QUARK && params.count !== undefined) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["count"], message: "search_pro_quark 不支持 count，请移除此参数。" });
+  }
+  const counts = COUNT_BY_ENGINE[params.search_engine];
+  if (counts && !counts.includes(params.count ?? 10)) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["count"], message: "search_pro_sogou 的 count 仅支持 10/20/30/40/50。" });
+  }
+}).transform(({ count, search_recency_filter, search_domain_filter, ...params }) => ({
+  ...params,
+  ...(params.search_engine === SEARCH_ENGINES.PRO_QUARK ? {} : { count: count ?? 10 }),
+  ...(search_domain_filter ? { search_domain_filter } : {}),
+  // noLimit 与省略均表示不限时间；省略可避免无意中同时指定域名和时间字段。
+  ...(search_recency_filter === RECENCY_FILTERS.NO_LIMIT ? {} : { search_recency_filter })
+}));