mcp-log-query-server 3.5.2 → 3.5.3

package/index.js

@@ -67,7 +67,7 @@ process.on('uncaughtException', (err) => log(`[uncaughtException] ${err && err.s
 const server = new Server(
   {
     name: 'mcp-log-query',
-    version: '3.5.2',
+    version: '3.5.3',
   },
   {
     capabilities: {
@@ -857,7 +857,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
   const logPath = getLogFilePath();
-  log(`[MCP] Log Query Server v3.5.2 已启动 (超时保护 + SSH 并发限制 + 排队超时 + 文件日志 + 进程不自杀)`);
+  log(`[MCP] Log Query Server v3.5.3 已启动 (SSH排队超时 + Loki体超时 + 文件日志)`);
   if (logPath) log(`[MCP] 本地日志文件: ${logPath}`);
 }
 

package/loki-client.js

@@ -1,483 +1,488 @@
-/**
- * Grafana Loki API 客户端
- *
- * 通过 Grafana 代理接口查询 Loki 日志，支持：
- * - 日志查询（LogQL）
- * - 标签/标签值获取
- * - traceId 自动提取
- * - 服务名自动识别（从 filename 标签解析）
- * - 时间范围自动递进（1h → 24h → 72h → 7d）
- */
-
-import { LOKI_ENVIRONMENTS, LOKI_DEFAULTS } from './config.js';
-
-// Loki 查询超时（毫秒）
-const LOKI_FETCH_TIMEOUT = 30000;
-
-// 时间范围自动递进策略（毫秒）
-const AUTO_RANGE_STEPS = [
-  { range: 5 * 60 * 1000,            label: '5 分钟' },
-  { range: 30 * 60 * 1000,           label: '30 分钟' },
-  { range: 1 * 60 * 60 * 1000,       label: '1 小时' },
-  { range: 3 * 60 * 60 * 1000,       label: '3 小时' },
-  { range: 24 * 60 * 60 * 1000,      label: '24 小时' },
-];
-
-// ============================================================
-// 核心查询
-// ============================================================
-
-/**
- * 执行 Loki 日志查询
- * @param {string} envName - 环境名称，如 'cms'
- * @param {string} expr - LogQL 表达式
- * @param {Object} options - 查询选项
- * @param {number} options.from - 起始时间（毫秒时间戳），默认 1 小时前
- * @param {number} options.to - 结束时间（毫秒时间戳），默认当前
- * @param {number} options.maxLines - 最大返回行数，默认 100
- * @param {string} options.direction - 排序方向 'backward'|'forward'，默认 'backward'
- * @returns {Object} { logs: string[], labels: Object[], traceIds: string[], stats: Object }
- */
-export async function queryLoki(envName, expr, options = {}) {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const from = options.from || (now - LOKI_DEFAULTS.defaultTimeRange);
-  const to = options.to || now;
-  const maxLines = options.maxLines || LOKI_DEFAULTS.maxLines;
-  const direction = options.direction || 'backward';
-
-  const url = `${env.grafanaUrl}/api/ds/query?ds_type=loki`;
-  const body = {
-    queries: [{
-      refId: 'A',
-      expr,
-      queryType: 'range',
-      datasource: { type: 'loki', uid: env.datasourceUid },
-      editorMode: 'builder',
-      direction,
-      maxLines,
-      datasourceId: env.datasourceId,
-      intervalMs: 1000,
-      maxDataPoints: 1000
-    }],
-    from: String(from),
-    to: String(to)
-  };
-
-  console.error(`[Loki] 查询: env=${envName}, expr=${expr}`);
-
-  // 带超时的 fetch
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), LOKI_FETCH_TIMEOUT);
-
-  let resp;
-  try {
-    resp = await fetch(url, {
-      method: 'POST',
-      headers: buildHeaders(env),
-      body: JSON.stringify(body),
-      signal: controller.signal
-    });
-  } catch (e) {
-    clearTimeout(timer);
-    if (e.name === 'AbortError') {
-      throw new Error(`Loki 查询超时（${LOKI_FETCH_TIMEOUT}ms）`);
-    }
-    throw e;
-  } finally {
-    clearTimeout(timer);
-  }
-
-  if (!resp.ok) {
-    const text = await resp.text();
-    throw new Error(`Loki 查询失败 (${resp.status}): ${text}`);
-  }
-
-  const data = await resp.json();
-  return parseLokiResponse(data);
-}
-
-/**
- * 带时间范围自动递进的 Loki 查询
- *
- * 策略：1h → 24h → 72h → 7d，找到结果立即返回
- * 如果用户指定了 from/to，则直接使用指定范围，不递进
- *
- * @param {string} envName - 环境名称
- * @param {string} expr - LogQL 表达式
- * @param {Object} options - 查询选项
- * @param {number} options.from - 起始时间戳（毫秒），指定后不递进
- * @param {number} options.to - 结束时间戳（毫秒），指定后不递进
- * @param {number} options.maxLines - 最大返回行数
- * @param {string} options.direction - 排序方向
- * @returns {Object} { logs, labels, traceIds, stats, timeRange: { label, from, to } }
- */
-export async function queryLokiAutoRange(envName, expr, options = {}) {
-  // 如果用户明确指定了 from/to，直接查询不递进
-  if (options.from && options.to) {
-    console.error(`[Loki] 使用指定时间范围查询: ${new Date(options.from).toLocaleString()} ~ ${new Date(options.to).toLocaleString()}`);
-    try {
-      const result = await queryLoki(envName, expr, options);
-      result.timeRange = { label: '自定义', from: options.from, to: options.to };
-      return result;
-    } catch (e) {
-      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
-      console.error(`[Loki] ❌ 指定时间范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
-      return {
-        logs: [], labels: [], traceIds: [], stats: null,
-        timeRange: { label: '自定义', from: options.from, to: options.to },
-        notFound: true,
-        error: isTimeout
-          ? '查询超时（数据量过大），请缩小时间范围或指定具体服务'
-          : `查询失败: ${e.message.substring(0, 200)}`
-      };
-    }
-  }
-
-  // 自动递进：从小范围到大范围
-  const now = Date.now();
-  for (const step of AUTO_RANGE_STEPS) {
-    const from = now - step.range;
-    const to = now;
-
-    console.error(`[Loki] 自动递进: 尝试 ${step.label} 范围...`);
-
-    try {
-      const result = await queryLoki(envName, expr, { ...options, from, to });
-
-      if (result.logs.length > 0) {
-        console.error(`[Loki] ✅ 在 ${step.label} 范围内找到 ${result.logs.length} 行日志`);
-        result.timeRange = { label: step.label, from, to };
-        return result;
-      }
-
-      console.error(`[Loki] ⏭️ ${step.label} 范围内无结果，扩大范围...`);
-    } catch (e) {
-      // 查询超时或失败，停止递进，返回优雅降级结果
-      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
-      console.error(`[Loki] ⚠️ ${step.label} 范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
-      return {
-        logs: [], labels: [], traceIds: [], stats: null,
-        timeRange: { label: step.label, from, to },
-        notFound: true,
-        error: isTimeout
-          ? `查询在递进到 ${step.label} 范围时超时（数据量过大），请缩小时间范围或指定具体服务查询`
-          : `查询在递进到 ${step.label} 范围时失败: ${e.message.substring(0, 200)}`
-      };
-    }
-  }
-
-  // 所有范围都没找到
-  console.error(`[Loki] ❌ 所有时间范围均未找到结果`);
-  return {
-    logs: [],
-    labels: [],
-    traceIds: [],
-    stats: null,
-    timeRange: { label: '未找到', from: null, to: null },
-    notFound: true
-  };
-}
-
-/**
- * 解析用户传入的时间字符串为毫秒时间戳
- * 支持格式: "2026-02-06 12:00:00", "2026-02-06", ISO 8601 等
- * @param {string} timeStr - 时间字符串
- * @returns {number|null} 毫秒时间戳，解析失败返回 null
- */
-export function parseTimeStr(timeStr) {
-  if (!timeStr) return null;
-  // 如果是纯数字，当作时间戳
-  if (/^\d{10,13}$/.test(timeStr)) {
-    const ts = parseInt(timeStr);
-    return ts < 1e12 ? ts * 1000 : ts; // 秒 → 毫秒
-  }
-  const d = new Date(timeStr);
-  return isNaN(d.getTime()) ? null : d.getTime();
-}
-
-// ============================================================
-// 标签查询
-// ============================================================
-
-/** 获取 Loki 标签列表 */
-export async function getLokiLabels(envName) {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
-  const end = now * 1_000_000;
-  const url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/labels?start=${start}&end=${end}`;
-  const resp = await fetch(url, { headers: buildHeaders(env) });
-  if (!resp.ok) throw new Error(`获取标签失败 (${resp.status})`);
-  const data = await resp.json();
-  return data.data || [];
-}
-
-/** 获取 Loki 标签值 */
-export async function getLokiLabelValues(envName, label, query = '') {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
-  const end = now * 1_000_000;
-  let url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/label/${label}/values?start=${start}&end=${end}`;
-  if (query) url += `&query=${encodeURIComponent(query)}`;
-  const resp = await fetch(url, { headers: buildHeaders(env) });
-  if (!resp.ok) throw new Error(`获取标签值失败 (${resp.status})`);
-  const data = await resp.json();
-  return data.data || [];
-}
-
-// ============================================================
-// 响应解析
-// ============================================================
-
-/** 解析 Grafana Loki 查询响应 */
-export function parseLokiResponse(data) {
-  const result = { logs: [], labels: [], traceIds: [], stats: null };
-  const frames = data?.results?.A?.frames;
-  if (!frames || frames.length === 0) return result;
-
-  for (const frame of frames) {
-    const values = frame?.data?.values;
-    if (!values || values.length < 3) continue;
-    // values[0]: 标签数组, values[1]: 时间戳数组, values[2]: 日志行数组
-    const labelsArr = values[0] || [];
-    const linesArr = values[2] || [];
-    for (let i = 0; i < linesArr.length; i++) {
-      result.logs.push(linesArr[i]);
-      result.labels.push(labelsArr[i] || {});
-    }
-  }
-
-  result.traceIds = extractTraceIds(result.logs);
-
-  const stats = frames[0]?.schema?.meta?.stats;
-  if (stats) {
-    result.stats = {};
-    for (const s of stats) { result.stats[s.displayName] = s.value; }
-  }
-  return result;
-}
-
-// ============================================================
-// traceId 提取
-// ============================================================
-
-/**
- * 从日志行中提取 traceId（32位十六进制，在方括号中）
- * 日志格式: [clife-senior] 时间 级别 [服务] [pod] [线程] [OT-spanId] [traceId] 类名 - 内容
- */
-export function extractTraceIds(lines) {
-  const traceIdSet = new Set();
-
-  const regex = /\[([a-f0-9]{32})\]/gi;
-  for (const line of lines) {
-    let match;
-    while ((match = regex.exec(line)) !== null) {
-      traceIdSet.add(match[1].toLowerCase());
-    }
-    regex.lastIndex = 0;
-  }
-  return [...traceIdSet];
-}
-
-// ============================================================
-// 服务名解析
-// ============================================================
-
-/**
- * 从 Loki filename 标签中解析服务名
- * filename 格式: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
- * 解析结果: clife-senior-health
- */
-export function parseServiceFromFilename(filename) {
-  if (!filename) return null;
-  // 匹配 /{service-name}-app/ 或 /{service-name}-service/ 模式
-  const match = filename.match(/\/(clife-senior-[a-zA-Z0-9-]+?)(?:-app|-service)\//);
-  if (match) return match[1];
-  // 兜底：匹配非 clife-senior 前缀的服务（如 device-manage-service）
-  const match2 = filename.match(/\/([a-zA-Z0-9-]+?)(?:-app|-service)\//);
-  if (match2) return match2[1];
-  return null;
-}
-
-/**
- * 将查询结果按服务分组
- * @param {Object} lokiResult - parseLokiResponse 的返回值
- * @returns {Object} { serviceName: { logs: string[], traceIds: string[] } }
- */
-export function groupLogsByService(lokiResult) {
-  const groups = {};
-
-  for (let i = 0; i < lokiResult.logs.length; i++) {
-    const label = lokiResult.labels[i] || {};
-    const serviceName = parseServiceFromFilename(label.filename) || 'unknown';
-    const logLine = lokiResult.logs[i];
-
-    if (!groups[serviceName]) {
-      groups[serviceName] = { logs: [], traceIds: new Set() };
-    }
-    groups[serviceName].logs.push(logLine);
-
-    // 从该行提取 traceId
-    const ids = extractTraceIds([logLine]);
-    ids.forEach(id => groups[serviceName].traceIds.add(id));
-  }
-
-  // Set → Array
-  for (const key of Object.keys(groups)) {
-    groups[key].traceIds = [...groups[key].traceIds];
-  }
-
-  return groups;
-}
-
-// ============================================================
-// LogQL 构建辅助
-// ============================================================
-
-/**
- * 构建按服务查询的 LogQL 表达式
- * 根据环境是否有 project 标签，自动选择不同的 filename 路径格式：
- *   - 有 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'
- * @param {string} servicePodPattern - 服务目录名，如 'clife-senior-health-app'
- * @param {string} keyword - 搜索关键词（可选）
- * @param {string} envName - 环境名称，如 'cms'、'chengyang'
- */
-export function buildServiceLogQL(project, servicePodPattern, keyword = '', envName = '') {
-  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  // CMS: /data/services/logs/senior/xxx-app/...  私有化: /data/services/logs/xxx-app/...
-  const filename = hasProject
-    ? `/data/services/logs/${project}/${servicePodPattern}/normal_logs/normal.log`
-    : `/data/services/logs/${servicePodPattern}/normal_logs/normal.log`;
-
-  let expr = `{filename="${filename}"}`;
-  if (keyword) {
-    expr += ` |= \`${keyword}\``;
-  }
-  return expr;
-}
-
-/**
- * 构建按项目查询的 LogQL 表达式（搜索整个项目所有服务）
- * 根据环境是否有 project 标签，自动选择不同的查询方式：
- *   - 有 project 标签（CMS）: {project="senior"} |= `keyword`
- *   - 无 project 标签（私有化）: {filename=~"/data/services/logs/clife-senior-.*normal.log"} |= `keyword`
- *
- * @param {string} project - 项目名，如 'senior'
- * @param {string} keyword - 搜索关键词
- * @param {string} envName - 环境名称，如 'cms'、'chengyang'
- */
-export function buildProjectLogQL(project, keyword, envName = '') {
-  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  if (hasProject) {
-    // CMS: 直接用 project 标签，高效精确
-    return `{project="${project}"} |= \`${keyword}\``;
-  } else {
-    // 私有化: 用 filename 正则匹配所有 clife-{project}-* 服务的 normal.log
-    return `{filename=~"/data/services/logs/clife-${project}-.*normal.log"} |= \`${keyword}\``;
-  }
-}
-
-// ============================================================
-// 内部辅助函数
-// ============================================================
-
-/** 获取 Loki 环境配置 */
-function getLokiEnv(envName) {
-  const env = LOKI_ENVIRONMENTS[envName];
-  if (!env) {
-    const available = Object.keys(LOKI_ENVIRONMENTS).join(', ');
-    throw new Error(`未知的 Loki 环境 "${envName}"，可用环境: ${available}`);
-  }
-  return env;
-}
-
-/** 构建请求头 */
-function buildHeaders(env) {
-  const headers = {
-    'Content-Type': 'application/json',
-    'Accept': 'application/json',
-    'x-grafana-org-id': String(env.orgId || 1),
-    'x-plugin-id': 'loki',
-    'x-datasource-uid': env.datasourceUid
-  };
-
-  // 如果配置了认证信息，添加 Basic Auth
-  if (env.username && env.password) {
-    const auth = Buffer.from(`${env.username}:${env.password}`).toString('base64');
-    headers['Authorization'] = `Basic ${auth}`;
-  }
-
-  return headers;
-}
-
-// ============================================================
-// 公共辅助函数
-// ============================================================
-
-/** 获取所有可用的 Loki 环境列表 */
-export function listLokiEnvironments() {
-  return Object.entries(LOKI_ENVIRONMENTS).map(([key, env]) => ({
-    name: key,
-    description: env.description,
-    grafanaUrl: env.grafanaUrl,
-    project: env.defaultProject
-  }));
-}
-
-/**
- * 获取指定环境下的服务列表（从 Loki filename 标签动态获取）
- * 根据环境是否有 project 标签，使用不同的查询方式：
- *   - 有 project 标签（CMS）: 用 {project="senior"} 过滤
- *   - 无 project 标签（私有化）: 获取全部 filename 后按 clife-{project}- 前缀过滤
- *
- * @param {string} envName - 环境名称
- * @param {string} project - 项目名，如 'senior'
- * @returns {string[]} 服务名列表
- */
-export async function listLokiServices(envName, project = 'senior') {
-  const env = LOKI_ENVIRONMENTS[envName];
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  let filenames;
-  if (hasProject) {
-    // CMS: 直接用 project 标签过滤
-    filenames = await getLokiLabelValues(envName, 'filename', `{project="${project}"}`);
-  } else {
-    // 私有化: 获取全部 filename，然后按 clife-{project}- 前缀过滤
-    filenames = await getLokiLabelValues(envName, 'filename');
-    filenames = filenames.filter(f => f.includes(`/clife-${project}-`));
-  }
-
-  const serviceSet = new Set();
-  for (const f of filenames) {
-    if (!f.includes('/normal_logs/normal.log')) continue;
-    const svc = parseServiceFromFilename(f);
-    if (svc) serviceSet.add(svc);
-  }
-
-  return [...serviceSet].sort();
-}
-
-/**
- * 根据服务简称获取 Loki 中的服务目录名
- * 例如: 'health' → 'clife-senior-health-app'
- * @param {string} serviceName - 服务简称，如 'health', 'core', 'gateway'
- * @returns {string} 服务目录名
- */
-export function getLokiServiceDirName(serviceName) {
-  // 如果已经是完整名称，直接返回
-  if (serviceName.startsWith('clife-senior-')) {
-    return serviceName.endsWith('-app') ? serviceName : `${serviceName}-app`;
-  }
-  // 简称转完整名称
-  return `clife-senior-${serviceName}-app`;
-}
+/**
+ * Grafana Loki API 客户端
+ *
+ * 通过 Grafana 代理接口查询 Loki 日志，支持：
+ * - 日志查询（LogQL）
+ * - 标签/标签值获取
+ * - traceId 自动提取
+ * - 服务名自动识别（从 filename 标签解析）
+ * - 时间范围自动递进（1h → 24h → 72h → 7d）
+ */
+
+import { LOKI_ENVIRONMENTS, LOKI_DEFAULTS } from './config.js';
+import { log } from './logger.js';
+
+// Loki 查询超时（毫秒）
+const LOKI_FETCH_TIMEOUT = 30000;
+
+// 时间范围自动递进策略（毫秒）
+const AUTO_RANGE_STEPS = [
+  { range: 5 * 60 * 1000,            label: '5 分钟' },
+  { range: 30 * 60 * 1000,           label: '30 分钟' },
+  { range: 1 * 60 * 60 * 1000,       label: '1 小时' },
+  { range: 3 * 60 * 60 * 1000,       label: '3 小时' },
+  { range: 24 * 60 * 60 * 1000,      label: '24 小时' },
+];
+
+// ============================================================
+// 核心查询
+// ============================================================
+
+/**
+ * 执行 Loki 日志查询
+ * @param {string} envName - 环境名称，如 'cms'
+ * @param {string} expr - LogQL 表达式
+ * @param {Object} options - 查询选项
+ * @param {number} options.from - 起始时间（毫秒时间戳），默认 1 小时前
+ * @param {number} options.to - 结束时间（毫秒时间戳），默认当前
+ * @param {number} options.maxLines - 最大返回行数，默认 100
+ * @param {string} options.direction - 排序方向 'backward'|'forward'，默认 'backward'
+ * @returns {Object} { logs: string[], labels: Object[], traceIds: string[], stats: Object }
+ */
+export async function queryLoki(envName, expr, options = {}) {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const from = options.from || (now - LOKI_DEFAULTS.defaultTimeRange);
+  const to = options.to || now;
+  const maxLines = options.maxLines || LOKI_DEFAULTS.maxLines;
+  const direction = options.direction || 'backward';
+
+  const url = `${env.grafanaUrl}/api/ds/query?ds_type=loki`;
+  const body = {
+    queries: [{
+      refId: 'A',
+      expr,
+      queryType: 'range',
+      datasource: { type: 'loki', uid: env.datasourceUid },
+      editorMode: 'builder',
+      direction,
+      maxLines,
+      datasourceId: env.datasourceId,
+      intervalMs: 1000,
+      maxDataPoints: 1000
+    }],
+    from: String(from),
+    to: String(to)
+  };
+
+  log(`[Loki] 查询: env=${envName}, expr=${expr}`);
+
+  // 带超时的 fetch —— AbortController 覆盖 fetch + body 读取全过程
+  // 之前的 bug：fetch resolve 后立刻 clearTimeout，导致 resp.json() 读 body 卡住时无保护
+  const controller = new AbortController();
+  const timer = setTimeout(() => {
+    log(`[Loki] ⏱ 超时 ${LOKI_FETCH_TIMEOUT}ms，主动 abort: env=${envName}, expr=${expr.substring(0, 80)}`);
+    controller.abort();
+  }, LOKI_FETCH_TIMEOUT);
+
+  try {
+    const resp = await fetch(url, {
+      method: 'POST',
+      headers: buildHeaders(env),
+      body: JSON.stringify(body),
+      signal: controller.signal
+    });
+
+    if (!resp.ok) {
+      // 读错误响应体同样受 signal 保护
+      const text = await resp.text();
+      throw new Error(`Loki 查询失败 (${resp.status}): ${text}`);
+    }
+
+    // 读 body 仍在 controller.signal 保护之下：body 卡住会被 abort
+    const data = await resp.json();
+    return parseLokiResponse(data);
+  } catch (e) {
+    if (e.name === 'AbortError') {
+      throw new Error(`Loki 查询超时（${LOKI_FETCH_TIMEOUT}ms）`);
+    }
+    throw e;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/**
+ * 带时间范围自动递进的 Loki 查询
+ *
+ * 策略：1h → 24h → 72h → 7d，找到结果立即返回
+ * 如果用户指定了 from/to，则直接使用指定范围，不递进
+ *
+ * @param {string} envName - 环境名称
+ * @param {string} expr - LogQL 表达式
+ * @param {Object} options - 查询选项
+ * @param {number} options.from - 起始时间戳（毫秒），指定后不递进
+ * @param {number} options.to - 结束时间戳（毫秒），指定后不递进
+ * @param {number} options.maxLines - 最大返回行数
+ * @param {string} options.direction - 排序方向
+ * @returns {Object} { logs, labels, traceIds, stats, timeRange: { label, from, to } }
+ */
+export async function queryLokiAutoRange(envName, expr, options = {}) {
+  // 如果用户明确指定了 from/to，直接查询不递进
+  if (options.from && options.to) {
+    log(`[Loki] 使用指定时间范围查询: ${new Date(options.from).toLocaleString()} ~ ${new Date(options.to).toLocaleString()}`);
+    try {
+      const result = await queryLoki(envName, expr, options);
+      result.timeRange = { label: '自定义', from: options.from, to: options.to };
+      return result;
+    } catch (e) {
+      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
+      log(`[Loki] ❌ 指定时间范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
+      return {
+        logs: [], labels: [], traceIds: [], stats: null,
+        timeRange: { label: '自定义', from: options.from, to: options.to },
+        notFound: true,
+        error: isTimeout
+          ? '查询超时（数据量过大），请缩小时间范围或指定具体服务'
+          : `查询失败: ${e.message.substring(0, 200)}`
+      };
+    }
+  }
+
+  // 自动递进：从小范围到大范围
+  const now = Date.now();
+  for (const step of AUTO_RANGE_STEPS) {
+    const from = now - step.range;
+    const to = now;
+
+    log(`[Loki] 自动递进: 尝试 ${step.label} 范围...`);
+
+    try {
+      const result = await queryLoki(envName, expr, { ...options, from, to });
+
+      if (result.logs.length > 0) {
+        log(`[Loki] ✅ 在 ${step.label} 范围内找到 ${result.logs.length} 行日志`);
+        result.timeRange = { label: step.label, from, to };
+        return result;
+      }
+
+      log(`[Loki] ⏭️ ${step.label} 范围内无结果，扩大范围...`);
+    } catch (e) {
+      // 查询超时或失败，停止递进，返回优雅降级结果
+      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
+      log(`[Loki] ⚠️ ${step.label} 范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
+      return {
+        logs: [], labels: [], traceIds: [], stats: null,
+        timeRange: { label: step.label, from, to },
+        notFound: true,
+        error: isTimeout
+          ? `查询在递进到 ${step.label} 范围时超时（数据量过大），请缩小时间范围或指定具体服务查询`
+          : `查询在递进到 ${step.label} 范围时失败: ${e.message.substring(0, 200)}`
+      };
+    }
+  }
+
+  // 所有范围都没找到
+  log(`[Loki] ❌ 所有时间范围均未找到结果`);
+  return {
+    logs: [],
+    labels: [],
+    traceIds: [],
+    stats: null,
+    timeRange: { label: '未找到', from: null, to: null },
+    notFound: true
+  };
+}
+
+/**
+ * 解析用户传入的时间字符串为毫秒时间戳
+ * 支持格式: "2026-02-06 12:00:00", "2026-02-06", ISO 8601 等
+ * @param {string} timeStr - 时间字符串
+ * @returns {number|null} 毫秒时间戳，解析失败返回 null
+ */
+export function parseTimeStr(timeStr) {
+  if (!timeStr) return null;
+  // 如果是纯数字，当作时间戳
+  if (/^\d{10,13}$/.test(timeStr)) {
+    const ts = parseInt(timeStr);
+    return ts < 1e12 ? ts * 1000 : ts; // 秒 → 毫秒
+  }
+  const d = new Date(timeStr);
+  return isNaN(d.getTime()) ? null : d.getTime();
+}
+
+// ============================================================
+// 标签查询
+// ============================================================
+
+/** 获取 Loki 标签列表 */
+export async function getLokiLabels(envName) {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
+  const end = now * 1_000_000;
+  const url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/labels?start=${start}&end=${end}`;
+  const resp = await fetch(url, { headers: buildHeaders(env) });
+  if (!resp.ok) throw new Error(`获取标签失败 (${resp.status})`);
+  const data = await resp.json();
+  return data.data || [];
+}
+
+/** 获取 Loki 标签值 */
+export async function getLokiLabelValues(envName, label, query = '') {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
+  const end = now * 1_000_000;
+  let url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/label/${label}/values?start=${start}&end=${end}`;
+  if (query) url += `&query=${encodeURIComponent(query)}`;
+  const resp = await fetch(url, { headers: buildHeaders(env) });
+  if (!resp.ok) throw new Error(`获取标签值失败 (${resp.status})`);
+  const data = await resp.json();
+  return data.data || [];
+}
+
+// ============================================================
+// 响应解析
+// ============================================================
+
+/** 解析 Grafana Loki 查询响应 */
+export function parseLokiResponse(data) {
+  const result = { logs: [], labels: [], traceIds: [], stats: null };
+  const frames = data?.results?.A?.frames;
+  if (!frames || frames.length === 0) return result;
+
+  for (const frame of frames) {
+    const values = frame?.data?.values;
+    if (!values || values.length < 3) continue;
+    // values[0]: 标签数组, values[1]: 时间戳数组, values[2]: 日志行数组
+    const labelsArr = values[0] || [];
+    const linesArr = values[2] || [];
+    for (let i = 0; i < linesArr.length; i++) {
+      result.logs.push(linesArr[i]);
+      result.labels.push(labelsArr[i] || {});
+    }
+  }
+
+  result.traceIds = extractTraceIds(result.logs);
+
+  const stats = frames[0]?.schema?.meta?.stats;
+  if (stats) {
+    result.stats = {};
+    for (const s of stats) { result.stats[s.displayName] = s.value; }
+  }
+  return result;
+}
+
+// ============================================================
+// traceId 提取
+// ============================================================
+
+/**
+ * 从日志行中提取 traceId（32位十六进制，在方括号中）
+ * 日志格式: [clife-senior] 时间 级别 [服务] [pod] [线程] [OT-spanId] [traceId] 类名 - 内容
+ */
+export function extractTraceIds(lines) {
+  const traceIdSet = new Set();
+
+  const regex = /\[([a-f0-9]{32})\]/gi;
+  for (const line of lines) {
+    let match;
+    while ((match = regex.exec(line)) !== null) {
+      traceIdSet.add(match[1].toLowerCase());
+    }
+    regex.lastIndex = 0;
+  }
+  return [...traceIdSet];
+}
+
+// ============================================================
+// 服务名解析
+// ============================================================
+
+/**
+ * 从 Loki filename 标签中解析服务名
+ * filename 格式: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
+ * 解析结果: clife-senior-health
+ */
+export function parseServiceFromFilename(filename) {
+  if (!filename) return null;
+  // 匹配 /{service-name}-app/ 或 /{service-name}-service/ 模式
+  const match = filename.match(/\/(clife-senior-[a-zA-Z0-9-]+?)(?:-app|-service)\//);
+  if (match) return match[1];
+  // 兜底：匹配非 clife-senior 前缀的服务（如 device-manage-service）
+  const match2 = filename.match(/\/([a-zA-Z0-9-]+?)(?:-app|-service)\//);
+  if (match2) return match2[1];
+  return null;
+}
+
+/**
+ * 将查询结果按服务分组
+ * @param {Object} lokiResult - parseLokiResponse 的返回值
+ * @returns {Object} { serviceName: { logs: string[], traceIds: string[] } }
+ */
+export function groupLogsByService(lokiResult) {
+  const groups = {};
+
+  for (let i = 0; i < lokiResult.logs.length; i++) {
+    const label = lokiResult.labels[i] || {};
+    const serviceName = parseServiceFromFilename(label.filename) || 'unknown';
+    const logLine = lokiResult.logs[i];
+
+    if (!groups[serviceName]) {
+      groups[serviceName] = { logs: [], traceIds: new Set() };
+    }
+    groups[serviceName].logs.push(logLine);
+
+    // 从该行提取 traceId
+    const ids = extractTraceIds([logLine]);
+    ids.forEach(id => groups[serviceName].traceIds.add(id));
+  }
+
+  // Set → Array
+  for (const key of Object.keys(groups)) {
+    groups[key].traceIds = [...groups[key].traceIds];
+  }
+
+  return groups;
+}
+
+// ============================================================
+// LogQL 构建辅助
+// ============================================================
+
+/**
+ * 构建按服务查询的 LogQL 表达式
+ * 根据环境是否有 project 标签，自动选择不同的 filename 路径格式：
+ *   - 有 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'
+ * @param {string} servicePodPattern - 服务目录名，如 'clife-senior-health-app'
+ * @param {string} keyword - 搜索关键词（可选）
+ * @param {string} envName - 环境名称，如 'cms'、'chengyang'
+ */
+export function buildServiceLogQL(project, servicePodPattern, keyword = '', envName = '') {
+  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  // CMS: /data/services/logs/senior/xxx-app/...  私有化: /data/services/logs/xxx-app/...
+  const filename = hasProject
+    ? `/data/services/logs/${project}/${servicePodPattern}/normal_logs/normal.log`
+    : `/data/services/logs/${servicePodPattern}/normal_logs/normal.log`;
+
+  let expr = `{filename="${filename}"}`;
+  if (keyword) {
+    expr += ` |= \`${keyword}\``;
+  }
+  return expr;
+}
+
+/**
+ * 构建按项目查询的 LogQL 表达式（搜索整个项目所有服务）
+ * 根据环境是否有 project 标签，自动选择不同的查询方式：
+ *   - 有 project 标签（CMS）: {project="senior"} |= `keyword`
+ *   - 无 project 标签（私有化）: {filename=~"/data/services/logs/clife-senior-.*normal.log"} |= `keyword`
+ *
+ * @param {string} project - 项目名，如 'senior'
+ * @param {string} keyword - 搜索关键词
+ * @param {string} envName - 环境名称，如 'cms'、'chengyang'
+ */
+export function buildProjectLogQL(project, keyword, envName = '') {
+  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  if (hasProject) {
+    // CMS: 直接用 project 标签，高效精确
+    return `{project="${project}"} |= \`${keyword}\``;
+  } else {
+    // 私有化: 用 filename 正则匹配所有 clife-{project}-* 服务的 normal.log
+    return `{filename=~"/data/services/logs/clife-${project}-.*normal.log"} |= \`${keyword}\``;
+  }
+}
+
+// ============================================================
+// 内部辅助函数
+// ============================================================
+
+/** 获取 Loki 环境配置 */
+function getLokiEnv(envName) {
+  const env = LOKI_ENVIRONMENTS[envName];
+  if (!env) {
+    const available = Object.keys(LOKI_ENVIRONMENTS).join(', ');
+    throw new Error(`未知的 Loki 环境 "${envName}"，可用环境: ${available}`);
+  }
+  return env;
+}
+
+/** 构建请求头 */
+function buildHeaders(env) {
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+    'x-grafana-org-id': String(env.orgId || 1),
+    'x-plugin-id': 'loki',
+    'x-datasource-uid': env.datasourceUid
+  };
+
+  // 如果配置了认证信息，添加 Basic Auth
+  if (env.username && env.password) {
+    const auth = Buffer.from(`${env.username}:${env.password}`).toString('base64');
+    headers['Authorization'] = `Basic ${auth}`;
+  }
+
+  return headers;
+}
+
+// ============================================================
+// 公共辅助函数
+// ============================================================
+
+/** 获取所有可用的 Loki 环境列表 */
+export function listLokiEnvironments() {
+  return Object.entries(LOKI_ENVIRONMENTS).map(([key, env]) => ({
+    name: key,
+    description: env.description,
+    grafanaUrl: env.grafanaUrl,
+    project: env.defaultProject
+  }));
+}
+
+/**
+ * 获取指定环境下的服务列表（从 Loki filename 标签动态获取）
+ * 根据环境是否有 project 标签，使用不同的查询方式：
+ *   - 有 project 标签（CMS）: 用 {project="senior"} 过滤
+ *   - 无 project 标签（私有化）: 获取全部 filename 后按 clife-{project}- 前缀过滤
+ *
+ * @param {string} envName - 环境名称
+ * @param {string} project - 项目名，如 'senior'
+ * @returns {string[]} 服务名列表
+ */
+export async function listLokiServices(envName, project = 'senior') {
+  const env = LOKI_ENVIRONMENTS[envName];
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  let filenames;
+  if (hasProject) {
+    // CMS: 直接用 project 标签过滤
+    filenames = await getLokiLabelValues(envName, 'filename', `{project="${project}"}`);
+  } else {
+    // 私有化: 获取全部 filename，然后按 clife-{project}- 前缀过滤
+    filenames = await getLokiLabelValues(envName, 'filename');
+    filenames = filenames.filter(f => f.includes(`/clife-${project}-`));
+  }
+
+  const serviceSet = new Set();
+  for (const f of filenames) {
+    if (!f.includes('/normal_logs/normal.log')) continue;
+    const svc = parseServiceFromFilename(f);
+    if (svc) serviceSet.add(svc);
+  }
+
+  return [...serviceSet].sort();
+}
+
+/**
+ * 根据服务简称获取 Loki 中的服务目录名
+ * 例如: 'health' → 'clife-senior-health-app'
+ * @param {string} serviceName - 服务简称，如 'health', 'core', 'gateway'
+ * @returns {string} 服务目录名
+ */
+export function getLokiServiceDirName(serviceName) {
+  // 如果已经是完整名称，直接返回
+  if (serviceName.startsWith('clife-senior-')) {
+    return serviceName.endsWith('-app') ? serviceName : `${serviceName}-app`;
+  }
+  // 简称转完整名称
+  return `clife-senior-${serviceName}-app`;
+}

package/package.json

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