mcp-log-query-server 3.6.0 → 3.7.0

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/loki-client.js

@@ -362,21 +362,29 @@ export function groupLogsByService(lokiResult) {
 /**
  * 构建按服务查询的 LogQL 表达式
  * 根据环境是否有 project 标签，自动选择不同的 filename 路径格式：
- *   - 有 project 标签（CMS）: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
+ *   - 有 project 标签（CMS / 预发布）: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
  *   - 无 project 标签（私有化）: /data/services/logs/clife-senior-health-app/normal_logs/normal.log
  *
- * @param {string} project - 项目名，如 'senior'
+ * 注意 path 与 label 的差异：
+ *   - 预发布 label 是 'pre-senior'（用于 LogQL 标签匹配，不在这里）
+ *   - 预发布 path 仍然是 'senior'（写在 filename 路径里）
+ *   通过环境配置的 pathProject 字段单独控制路径段，避免与 label 混用
+ *
+ * @param {string} project - 项目 label，如 'senior' / 'pre-senior'（仅当环境无 pathProject 字段时回退使用）
  * @param {string} servicePodPattern - 服务目录名，如 'clife-senior-health-app'
  * @param {string} keyword - 搜索关键词（可选）
- * @param {string} envName - 环境名称，如 'cms'、'chengyang'
+ * @param {string} envName - 环境名称，如 'cms'、'pre'、'chengyang'
  */
 export function buildServiceLogQL(project, servicePodPattern, keyword = '', envName = '') {
   const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
   const hasProject = env ? env.hasProjectLabel !== false : true;
+  // 路径段优先使用 env.pathProject（预发布需要 label='pre-senior' 但 path='senior'），回退到 project
+  const pathSegment = (env && env.pathProject) || project;
 
-  // CMS: /data/services/logs/senior/xxx-app/...  私有化: /data/services/logs/xxx-app/...
+  // 有 project 标签的环境: /data/services/logs/{pathSegment}/xxx-app/...
+  // 无 project 标签的环境: /data/services/logs/xxx-app/...
   const filename = hasProject
-    ? `/data/services/logs/${project}/${servicePodPattern}/normal_logs/normal.log`
+    ? `/data/services/logs/${pathSegment}/${servicePodPattern}/normal_logs/normal.log`
     : `/data/services/logs/${servicePodPattern}/normal_logs/normal.log`;
 
   let expr = `{filename="${filename}"}`;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "mcp-log-query-server",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "MCP Server for querying server logs via SSH jump host and Grafana Loki API",
   "main": "index.js",
   "type": "module",
   "bin": {
-    "mcp-log-query": "./index.js"
+    "mcp-log-query": "index.js"
   },
   "files": [
     "index.js",
@@ -37,7 +37,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/huawang1258/mcp-services.git"
+    "url": "git+https://github.com/huawang1258/mcp-services.git"
   },
   "homepage": "https://github.com/huawang1258/mcp-services#readme"
 }