sciverse-mcp-server 0.11.0 → 0.11.2

package/dist/generated/tools.d.ts

@@ -1,4 +1,4 @@
-export declare const TOOLS_VERSION = "0.11.0";
+export declare const TOOLS_VERSION = "0.11.2";
 export interface ToolDef {
     name: string;
     description: string;

package/dist/generated/tools.js

@@ -1,6 +1,6 @@
 // Auto-generated by scripts/gen-tools.mjs. Do not edit.
 // Source of truth: openapi.yaml
-export const TOOLS_VERSION = "0.11.0";
+export const TOOLS_VERSION = "0.11.2";
 export const TOOLS = [
     {
         "name": "search_papers",
@@ -171,7 +171,8 @@ export const TOOLS = [
                     "type": "integer",
                     "default": 10,
                     "minimum": 1,
-                    "maximum": 30
+                    "maximum": 100,
+                    "description": "返回命中条数上限，合法 1-100（服务端校验，超出报 400）。\n实际条数还受 mode 影响：balanced 单路混合召回在服务端固定截到约 50 条，\ntop_k 超过 50 时多出的部分不会返回；fast 与 quality 可取到 top_k。\n另外同一篇论文最多返回约 3 个 chunk，因此高 top_k 需要命中足够多的不同论文。\n"
                 },
                 "source_types": {
                     "type": "array",

package/dist/tools.js

@@ -58,6 +58,25 @@ function toBackendPayload(args) {
         out.sort = sort;
     return out;
 }
+// 上游 agentic-search（Go 服务）没有 mode 字段，未知字段会被静默丢弃，
+// 所以 mode 必须在这里翻译为上游真实参数 retrieval / sub_queries。
+// 与 packages/typescript/src/client.ts 的 SEMANTIC_MODE_MAP 保持一致（同 toBackendPayload 的复制约定）。
+const SEMANTIC_MODE_MAP = {
+    fast: { retrieval: "es" },
+    balanced: { retrieval: "hybrid" },
+    quality: { retrieval: "hybrid", sub_queries: 3 },
+};
+function toSemanticSearchPayload(args) {
+    const { mode, ...rest } = args;
+    if (mode === undefined || mode === null)
+        return rest;
+    const mapped = SEMANTIC_MODE_MAP[mode];
+    if (!mapped) {
+        throw new Error(`mode must be one of ${Object.keys(SEMANTIC_MODE_MAP).join(" / ")}, got ${JSON.stringify(mode)}`);
+    }
+    // 显式传入的 retrieval / sub_queries 优先于 mode 映射。
+    return { ...mapped, ...rest };
+}
 const PLATFORM = process.platform;
 async function call(config, method, path, options = {}) {
     const url = new URL(`${config.baseUrl}${path}`);
@@ -152,8 +171,19 @@ export async function executeTool(config, name, args) {
     switch (name) {
         case "search_papers":
             return call(config, "POST", endpoint.path, { body: toBackendPayload(args) });
-        case "semantic_search":
-            return call(config, "POST", endpoint.path, { body: args });
+        case "semantic_search": {
+            let body;
+            try {
+                body = toSemanticSearchPayload(args);
+            }
+            catch (e) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: JSON.stringify({ error: e.message }) }],
+                };
+            }
+            return call(config, "POST", endpoint.path, { body });
+        }
         case "list_catalog": {
             const { include_sample_values, include_field_stats, collection } = args;
             const query = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sciverse-mcp-server",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Sciverse MCP server — exposes academic paper retrieval (search_papers / semantic_search / read_content) to MCP-compatible coding agents (Claude Code, Cursor, Codex CLI, Windsurf, ...).",
   "license": "Apache-2.0",
   "homepage": "https://github.com/opendatalab/Sciverse-Agent-Tools/tree/main/packages/mcp",