@zltquant/zlt-mcp 0.4.2 → 0.5.0-beta.0

package/README.md

@@ -14,6 +14,12 @@ npx -y @zltquant/zlt-mcp list --json
 npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
 ```
 
+业务调用支持 `call --output-json <新文件路径>`：完整 JSON 写入文件，stdout 返回含
+`ok`、`tool`、`resultFile`、`cliProvenance`、精简 `data` 的回执。
+输出目录须已存在，已有文件会在执行工具前报错；每次使用新文件名。完整参数与大段数据从结果文件读取。
+stderr 保留诊断，失败返回非零退出码。工具执行后若写文件失败，完整结果会输出到 stdout；先核对结果，不要自动重复执行。
+不传该参数时保持原有完整 stdout。
+
 其他支持原生 MCP 的客户端（Trae / Claude Code / Cursor 等）可以使用下面的配置：
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zltquant/zlt-mcp",
-  "version": "0.4.2",
+  "version": "0.5.0-beta.0",
   "description": "智量通 ZLT Quant MCP server（Windows x64；量化策略创建与本地回测）",
   "bin": {
     "zlt-mcp": "./zlt-mcp-proxy.bundle.cjs"

package/zlt-mcp-proxy.bundle.cjs

@@ -24936,6 +24936,12 @@ function echoResolvedBacktestConfig(tool, args, result, contexts) {
     const echoedRunId = typeof parsed.Data.runId === "string" ? parsed.Data.runId.trim() : "";
     const runId = echoedRunId || (tool.name === "mcp-re-backtest" && typeof args.runId === "string" ? args.runId.trim() : "");
     const context = runId ? contexts.get(runId) : void 0;
+    if (runId) echo.runId = runId;
+    if (context?.codePath) {
+      echo.codePath = context.codePath;
+      echo.runDir = context.codePath;
+    }
+    if (context?.runParams) echo.runParams = { ...context.runParams };
     if (context?.attemptStartedAtMs) {
       echo.attemptFence = {
         attemptStartedAtMs: context.attemptStartedAtMs,
@@ -27501,7 +27507,7 @@ function runtimeRecoveryStopData(message, extra = {}, handler = "runtimeStart")
 // src/index.ts
 var CLI_NAME = "zlt-mcp";
 var CLI_FALLBACK_PACKAGE_NAME = "@zltquant/zlt-mcp";
-var CLI_FALLBACK_VERSION = "0.4.2";
+var CLI_FALLBACK_VERSION = "0.5.0-beta.0";
 if (process.argv.length <= 2) {
   startMcpServer();
 } else {
@@ -27511,21 +27517,44 @@ if (process.argv.length <= 2) {
     if (kind !== "backtest") throw new Error(`Unsupported keepalive kind: ${kind}`);
     await keepMcpBacktestAlive(id, codePath);
   });
-  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the request").option("--no-progress", "Suppress progress diagnostics on stderr").action(async (tool, options) => {
+  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--output-json <path>", "Save the complete result to a new JSON file and print a compact receipt").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the request").option("--no-progress", "Suppress progress diagnostics on stderr").action(async (tool, options) => {
+    let outputFd;
     try {
       const args = parseMcpArgs(options.argsJson, options.argsFile);
+      const timeoutMs = parseTimeoutOption(options.timeoutMs, "--timeout-ms");
+      const maxTotalTimeoutMs = parseTimeoutOption(options.maxTotalTimeoutMs, "--max-total-timeout-ms");
+      const resultFile = options.outputJson === void 0 ? void 0 : path14.resolve(options.outputJson);
+      if (resultFile !== void 0) outputFd = fs13.openSync(resultFile, "wx");
       const result = await callMcpTool(tool, args, {
-        timeoutMs: parseTimeoutOption(options.timeoutMs, "--timeout-ms"),
-        maxTotalTimeoutMs: parseTimeoutOption(options.maxTotalTimeoutMs, "--max-total-timeout-ms"),
+        timeoutMs,
+        maxTotalTimeoutMs,
         showProgress: options.progress !== false
       });
-      process.stdout.write(JSON.stringify(withCliProvenance(result)) + "\n");
+      const complete = withCliProvenance(result);
+      const serialized = JSON.stringify(complete) + "\n";
+      if (outputFd !== void 0 && resultFile !== void 0) {
+        try {
+          fs13.writeFileSync(outputFd, serialized, "utf-8");
+          fs13.closeSync(outputFd);
+          outputFd = void 0;
+        } catch (error2) {
+          process.stdout.write(serialized);
+          throw new Error(`Tool returned a result, but saving ${resultFile} failed; complete result is on stdout. Do not repeat the tool automatically. ${String(error2)}`);
+        }
+        const receipt = compactCliReceipt(tool, complete, resultFile);
+        process.stdout.write(JSON.stringify(receipt) + "\n");
+        if (!receipt.ok) process.exitCode = 1;
+      } else {
+        process.stdout.write(serialized);
+      }
       if (result.isError === true) process.exitCode = 1;
     } catch (error2) {
       const message = error2 instanceof Error ? error2.message : String(error2);
       process.stderr.write(`Error: ${message}
 `);
       process.exitCode = 1;
+    } finally {
+      if (outputFd !== void 0) fs13.closeSync(outputFd);
     }
   });
   program2.command("list").description("List MCP tools exposed by the bundled server").option("--json", "Emit the complete tools/list response as JSON").action(async (options) => {
@@ -27619,6 +27648,46 @@ function resolveCliPackageProvenance() {
 function withCliProvenance(result) {
   return { ...result, cliProvenance: resolveCliPackageProvenance() };
 }
+function compactCliReceipt(tool, result, resultFile) {
+  const payload = parseMcpResult(result);
+  const code = payload?.ErrNo;
+  const ok = result.isError !== true && (code === void 0 || code === null || Number(code) === 0);
+  const source = payload?.Data;
+  const data = {};
+  if (source && typeof source === "object" && !Array.isArray(source)) {
+    const fields = source;
+    for (const key of [
+      "runId",
+      "backtestId",
+      "strategyId",
+      "localPath",
+      "codePath",
+      "runDir",
+      "attemptFence",
+      "status",
+      "progress",
+      "available",
+      "runtimeReady",
+      "backtestReady",
+      "nextAction",
+      "recommendedAction",
+      "error_code",
+      "error_msg"
+    ]) {
+      if (fields[key] !== void 0) {
+        data[key] = key === "error_msg" && typeof fields[key] === "string" ? fields[key].slice(0, 512) : fields[key];
+      }
+    }
+  }
+  return {
+    ok,
+    tool,
+    resultFile,
+    cliProvenance: result.cliProvenance,
+    data,
+    ...!ok ? { error: { code: code ?? null, message: String(payload?.ErrMsg ?? "Tool reported an error; see resultFile").slice(0, 512) } } : {}
+  };
+}
 function parseTimeoutOption(value, flag) {
   if (value === void 0) return void 0;
   const parsed = Number(value);