mcp-log-query-server 3.6.0 → 3.6.1

package/logger.js

@@ -1,9 +1,12 @@
 /**
- * 轻量日志模块：console.error + 本地文件追加
+ * 轻量日志模块：本地文件追加（默认不走 stderr）
  *
- * 为什么需要文件日志？
- * Windsurf 不会把 MCP server 的 stderr 落盘到 %APPDATA%\Windsurf\logs，
- * 只在 Output 面板实时显示。一旦进程重启、面板关闭，信息就丢了。
+ * ⚠️ 重要背景（3.6.1）：
+ * Windsurf 根本没有 MCP 专属的 Output 频道，从不读取子进程的 stderr。
+ * Node 默认 stderr pipe buffer ~64KB，满了后 `console.error` 会**同步阻塞 event loop**
+ * → 整个 MCP 进程冻结，新请求来了不处理，已发出的 fetch 不推进，cancel signal 也接收不到。
+ *
+ * 因此默认只写文件，stderr 仅在显式要求时开启（用于单独调试，MCP server 场景禁用）。
  *
  * 用法：
  *   import { log } from './logger.js';
@@ -16,7 +19,8 @@
  * 环境变量：
  * - MCP_LOG_FILE: 自定义日志文件路径（默认 <tmpdir>/mcp-log-query.log）
  * - MCP_LOG_MAX_BYTES: 单文件最大字节数（默认 10MB，超过则轮转到 .1）
- * - MCP_LOG_DISABLE: 设为 '1' 则禁用文件日志（只走 stderr）
+ * - MCP_LOG_DISABLE: 设为 '1' 则完全禁用日志（文件+stderr 都不写）
+ * - MCP_LOG_STDERR: 设为 '1' 时**同时**写 stderr（独立调试用，MCP 子进程模式下不要开）
  */
 
 import fs from 'node:fs';
@@ -26,6 +30,8 @@ import path from 'node:path';
 const LOG_FILE = process.env.MCP_LOG_FILE || path.join(os.tmpdir(), 'mcp-log-query.log');
 const MAX_BYTES = parseInt(process.env.MCP_LOG_MAX_BYTES || `${10 * 1024 * 1024}`, 10);
 const DISABLED = process.env.MCP_LOG_DISABLE === '1';
+// 默认不走 stderr（MCP 子进程下会被 host 无限 backpressure 阻塞 event loop）
+const WRITE_STDERR = process.env.MCP_LOG_STDERR === '1';
 
 // 懒初始化：首次写入时再检查目录
 let initialized = false;
@@ -41,8 +47,8 @@ function ensureInit() {
       LOG_FILE,
       `\n========== [${new Date().toISOString()}] MCP log-query 进程启动 pid=${process.pid} ==========\n`
     );
-  } catch (err) {
-    console.error('[logger] 初始化文件日志失败，仅使用 stderr:', err.message);
+  } catch {
+    // 文件初始化失败，静默（同 log 函数的考虑）
   }
 }
 
@@ -59,13 +65,14 @@ function rotateIfNeeded() {
 }
 
 /**
- * 写一条日志：stderr + 可选本地文件
+ * 写一条日志：默认仅本地文件；MCP_LOG_STDERR=1 时同时写 stderr
+ *
+ * ⚠️ 重要：MCP 子进程下 stderr 管道会被 host 无限 backpressure 阻塞 event loop，
+ * 所以默认禁用 stderr 输出。只在独立调试（非 MCP 模式）时开启。
+ *
  * @param {string} msg - 日志内容（不需要带时间戳，本函数自动加）
  */
 export function log(msg) {
-  // stderr 永远写，兼容 Windsurf Output 面板实时查看
-  console.error(msg);
-
   if (DISABLED) return;
 
   ensureInit();
@@ -74,12 +81,15 @@ export function log(msg) {
   try {
     rotateIfNeeded();
     fs.appendFileSync(LOG_FILE, line);
-  } catch (err) {
-    // 文件写失败不能影响主流程，但 stderr 提示一次
-    if (!log._warnedFileFail) {
-      log._warnedFileFail = true;
-      console.error('[logger] 写日志文件失败（后续不再提示）:', err.message);
-    }
+  } catch {
+    // 文件写失败静默忽略：不能为了日志去打 stderr（会阻塞 event loop）
+    // 也不缓存 warning；调试请检查磁盘 / 权限
+  }
+
+  // 可选 stderr 输出（独立调试用）
+  if (WRITE_STDERR) {
+    // 直接 write，失败忽略；不用 console.error 以免同步阻塞
+    try { process.stderr.write(msg + '\n'); } catch {}
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-log-query-server",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "MCP Server for querying server logs via SSH jump host and Grafana Loki API",
   "main": "index.js",
   "type": "module",