@zqagent/core 0.2.20 → 0.3.6

package/dist/internal/mcp/config.js

@@ -0,0 +1,235 @@
+// src/mcp/config.ts
+import fs from "fs";
+import path from "path";
+var TRANSPORT_TYPES = /* @__PURE__ */ new Set([
+  "stdio",
+  "http",
+  "sse",
+  "builtin"
+]);
+var BUILTIN_MCP_CONFIGS = [
+  { name: "ocr", type: "builtin", builtin: "ocr", enabled: true }
+];
+function defaultMcpConfigPath(workspace) {
+  return path.join(workspace, ".agent", "mcp.json");
+}
+function splitCommandLine(input) {
+  const out = [];
+  let cur = "";
+  let quote = null;
+  let escaped = false;
+  for (const ch of input) {
+    if (escaped) {
+      cur += ch;
+      escaped = false;
+      continue;
+    }
+    if (ch === "\\" && quote !== "'") {
+      escaped = true;
+      continue;
+    }
+    if (quote) {
+      if (ch === quote) quote = null;
+      else cur += ch;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch;
+      continue;
+    }
+    if (/\s/.test(ch)) {
+      if (cur) {
+        out.push(cur);
+        cur = "";
+      }
+      continue;
+    }
+    cur += ch;
+  }
+  if (escaped) cur += "\\";
+  if (cur) out.push(cur);
+  return out;
+}
+function expandEnv(value, env, name, warnings) {
+  return value.replace(
+    /\$\{(?:env:)?([A-Za-z_][A-Za-z0-9_]*)\}/g,
+    (_m, key) => {
+      const v = env[key];
+      if (v === void 0) {
+        warnings.push(`"${name}" \u5F15\u7528\u4E86\u672A\u5B9A\u4E49\u7684\u73AF\u5883\u53D8\u91CF \${${key}}`);
+        return "";
+      }
+      return v;
+    }
+  );
+}
+function toStringMap(raw, field, name, env, warnings) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    warnings.push(`"${name}".${field} \u5E94\u4E3A\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565`);
+    return void 0;
+  }
+  const out = {};
+  for (const [k, v] of Object.entries(raw)) {
+    if (v === void 0 || v === null) continue;
+    if (typeof v === "string") out[k] = expandEnv(v, env, name, warnings);
+    else if (typeof v === "number" || typeof v === "boolean")
+      out[k] = String(v);
+    else warnings.push(`"${name}".${field}.${k} \u4E0D\u662F\u5B57\u7B26\u4E32\uFF0C\u5DF2\u5FFD\u7565`);
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function normalizeMcpConfig(raw, fallbackName, opts = {}, warnings = []) {
+  const env = opts.env ?? process.env;
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    warnings.push(`MCP \u914D\u7F6E\u6761\u76EE${fallbackName ? ` "${fallbackName}"` : ""} \u4E0D\u662F\u5BF9\u8C61\uFF0C\u5DF2\u8DF3\u8FC7`);
+    return null;
+  }
+  const o = raw;
+  const name = typeof o.name === "string" && o.name.trim() ? o.name.trim() : fallbackName?.trim();
+  if (!name) {
+    warnings.push("MCP \u914D\u7F6E\u7F3A\u5C11 name\uFF0C\u5DF2\u8DF3\u8FC7");
+    return null;
+  }
+  const rawType = typeof o.type === "string" ? o.type.toLowerCase() : "";
+  let type;
+  if (TRANSPORT_TYPES.has(rawType)) type = rawType;
+  else if (rawType === "streamable-http" || rawType === "streamablehttp")
+    type = "http";
+  else if (typeof o.builtin === "string") type = "builtin";
+  else if (typeof o.url === "string")
+    type = /\/sse(?:[?#]|$)/i.test(o.url) ? "sse" : "http";
+  else if (o.command !== void 0) type = "stdio";
+  if (!type) {
+    warnings.push(`MCP "${name}" \u65E0\u6CD5\u63A8\u65AD\u4F20\u8F93\u7C7B\u578B\uFF08\u9700\u8981 builtin/command/url\uFF09`);
+    return null;
+  }
+  const enabled = o.enabled === false || o.disabled === true ? false : true;
+  const config = { name, type, enabled };
+  if (type === "stdio") {
+    const command = [];
+    if (Array.isArray(o.command)) {
+      for (const part of o.command) {
+        if (typeof part === "string") command.push(part);
+        else warnings.push(`MCP "${name}" \u7684 command \u542B\u975E\u5B57\u7B26\u4E32\u9879\uFF0C\u5DF2\u5FFD\u7565`);
+      }
+    } else if (typeof o.command === "string") {
+      command.push(...splitCommandLine(o.command));
+    }
+    if (Array.isArray(o.args)) {
+      for (const part of o.args) {
+        if (typeof part === "string") command.push(part);
+        else warnings.push(`MCP "${name}" \u7684 args \u542B\u975E\u5B57\u7B26\u4E32\u9879\uFF0C\u5DF2\u5FFD\u7565`);
+      }
+    } else if (typeof o.args === "string") {
+      command.push(...splitCommandLine(o.args));
+    }
+    if (command.length === 0) {
+      warnings.push(`MCP "${name}" \u7F3A\u5C11 command\uFF0C\u5DF2\u8DF3\u8FC7`);
+      return null;
+    }
+    config.command = command.map((c) => expandEnv(c, env, name, warnings));
+    if (typeof o.cwd === "string" && o.cwd.trim())
+      config.cwd = expandEnv(o.cwd, env, name, warnings);
+    const stdioEnv = toStringMap(o.env, "env", name, env, warnings);
+    if (stdioEnv) config.env = stdioEnv;
+  } else if (type === "builtin") {
+    config.builtin = typeof o.builtin === "string" && o.builtin.trim() ? o.builtin.trim() : name;
+  } else {
+    if (typeof o.url !== "string" || !o.url.trim()) {
+      warnings.push(`MCP "${name}" \u7F3A\u5C11 url\uFF0C\u5DF2\u8DF3\u8FC7`);
+      return null;
+    }
+    config.url = expandEnv(o.url.trim(), env, name, warnings);
+    const headers = toStringMap(o.headers, "headers", name, env, warnings);
+    if (headers) config.headers = headers;
+  }
+  return config;
+}
+function normalizeMcpConfigs(raw, opts = {}) {
+  const warnings = [];
+  const configs = [];
+  const add = (item, fallbackName) => {
+    const cfg = normalizeMcpConfig(item, fallbackName, opts, warnings);
+    if (!cfg) return;
+    const idx = configs.findIndex((c) => c.name === cfg.name);
+    if (idx >= 0) {
+      warnings.push(`MCP "${cfg.name}" \u91CD\u590D\u51FA\u73B0\uFF0C\u540E\u8005\u8986\u76D6\u524D\u8005`);
+      configs[idx] = cfg;
+    } else {
+      configs.push(cfg);
+    }
+  };
+  if (Array.isArray(raw)) {
+    for (const item of raw) add(item);
+  } else if (raw && typeof raw === "object") {
+    const o = raw;
+    const objectMap = (value) => {
+      if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+      for (const [k, v] of Object.entries(value))
+        add(v, k);
+      return true;
+    };
+    if (Array.isArray(o.servers)) {
+      for (const item of o.servers) add(item);
+    } else if (Array.isArray(o.mcpServers)) {
+      for (const item of o.mcpServers) add(item);
+    } else if (objectMap(o.mcpServers)) {
+    } else if (objectMap(o.servers)) {
+    } else {
+      add(o);
+    }
+  } else {
+    warnings.push("MCP \u914D\u7F6E\u5FC5\u987B\u662F JSON \u5BF9\u8C61\u6216\u6570\u7EC4");
+  }
+  return { configs, warnings };
+}
+function readMcpConfigFile(file, opts = {}) {
+  if (!file) return { configs: [], warnings: [] };
+  try {
+    if (!fs.existsSync(file)) return { configs: [], warnings: [] };
+    const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+    return normalizeMcpConfigs(raw, opts);
+  } catch (err) {
+    return {
+      configs: [],
+      warnings: [`\u8BFB\u53D6 MCP \u914D\u7F6E\u5931\u8D25 ${file}: ${err.message}`]
+    };
+  }
+}
+function saveMcpConfigFile(file, configs) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(
+    file,
+    JSON.stringify(
+      configs.map((c) => JSON.parse(JSON.stringify(c))),
+      null,
+      2
+    ) + "\n",
+    "utf8"
+  );
+}
+function withBuiltinMcpConfigs(configs) {
+  const existing = new Set(configs.map((c) => c.name));
+  const builtin = BUILTIN_MCP_CONFIGS.filter((c) => !existing.has(c.name)).map(
+    (c) => ({ ...c })
+  );
+  return [...configs, ...builtin];
+}
+function loadMcpConfigFile(file, opts = {}) {
+  const result = readMcpConfigFile(file, opts);
+  return { configs: withBuiltinMcpConfigs(result.configs), warnings: result.warnings };
+}
+export {
+  BUILTIN_MCP_CONFIGS,
+  defaultMcpConfigPath,
+  loadMcpConfigFile,
+  normalizeMcpConfig,
+  normalizeMcpConfigs,
+  readMcpConfigFile,
+  saveMcpConfigFile,
+  splitCommandLine,
+  withBuiltinMcpConfigs
+};
+//# sourceMappingURL=config.js.map

package/dist/internal/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/config.ts"],"sourcesContent":["/**\n * MCP 配置解析与持久化（CLI / server 共用）\n *\n * 支持多种来源格式，避免「拷一份别人的配置进来却静默失效」：\n *   - 裸数组：[{ name, type, command|url, ... }]\n *   - { servers: [...] } / { servers: { name: {...} } }\n *   - { mcpServers: [...] } / { mcpServers: { name: {...} } }（Claude Desktop / Cursor）\n *\n * 单条配置容错：\n *   - 省略 type 时按 builtin / url / command 推断\n *   - Claude 风格 command(string) + args(string[]) 合并为 command: string[]\n *   - env/headers 值允许数字与布尔（转字符串）\n *   - 字符串中的 ${VAR} / ${env:VAR} 用进程环境变量展开\n *\n * 内置服务器（如 OCR）默认追加：用户配置中存在同名条目时以用户条目为准，\n * 因此可以用 { name: \"ocr\", enabled: false } 关闭内置能力。\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { McpServerConfig, McpTransportType } from \"./McpClient.js\";\n\n/** 归一化结果 */\nexport interface McpConfigNormalizeResult {\n  configs: McpServerConfig[];\n  warnings: string[];\n}\n\n/** 归一化选项 */\nexport interface McpConfigNormalizeOptions {\n  /** 环境变量（默认 process.env），用于 ${VAR} 展开 */\n  env?: NodeJS.ProcessEnv;\n}\n\nconst TRANSPORT_TYPES: ReadonlySet<string> = new Set([\n  \"stdio\",\n  \"http\",\n  \"sse\",\n  \"builtin\",\n]);\n\n/** 内置 MCP 服务器默认配置（用户同名配置优先） */\nexport const BUILTIN_MCP_CONFIGS: ReadonlyArray<McpServerConfig> = [\n  { name: \"ocr\", type: \"builtin\", builtin: \"ocr\", enabled: true },\n];\n\n/** 工作区默认配置文件路径 */\nexport function defaultMcpConfigPath(workspace: string): string {\n  return path.join(workspace, \".agent\", \"mcp.json\");\n}\n\n/**\n * 拆分 shell 风格命令行（支持单/双引号与反斜杠转义）。\n * 用于兼容 `command: \"npx -y some-server\"` 这类单字符串写法。\n */\nexport function splitCommandLine(input: string): string[] {\n  const out: string[] = [];\n  let cur = \"\";\n  let quote: '\"' | \"'\" | null = null;\n  let escaped = false;\n  for (const ch of input) {\n    if (escaped) {\n      cur += ch;\n      escaped = false;\n      continue;\n    }\n    if (ch === \"\\\\\" && quote !== \"'\") {\n      escaped = true;\n      continue;\n    }\n    if (quote) {\n      if (ch === quote) quote = null;\n      else cur += ch;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\") {\n      quote = ch;\n      continue;\n    }\n    if (/\\s/.test(ch)) {\n      if (cur) {\n        out.push(cur);\n        cur = \"\";\n      }\n      continue;\n    }\n    cur += ch;\n  }\n  if (escaped) cur += \"\\\\\";\n  if (cur) out.push(cur);\n  return out;\n}\n\nfunction expandEnv(\n  value: string,\n  env: NodeJS.ProcessEnv,\n  name: string,\n  warnings: string[],\n): string {\n  return value.replace(\n    /\\$\\{(?:env:)?([A-Za-z_][A-Za-z0-9_]*)\\}/g,\n    (_m, key: string) => {\n      const v = env[key];\n      if (v === undefined) {\n        warnings.push(`\"${name}\" 引用了未定义的环境变量 \\${${key}}`);\n        return \"\";\n      }\n      return v;\n    },\n  );\n}\n\nfunction toStringMap(\n  raw: unknown,\n  field: string,\n  name: string,\n  env: NodeJS.ProcessEnv,\n  warnings: string[],\n): Record<string, string> | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"object\" || Array.isArray(raw)) {\n    warnings.push(`\"${name}\".${field} 应为对象，已忽略`);\n    return undefined;\n  }\n  const out: Record<string, string> = {};\n  for (const [k, v] of Object.entries(raw as Record<string, unknown>)) {\n    if (v === undefined || v === null) continue;\n    if (typeof v === \"string\") out[k] = expandEnv(v, env, name, warnings);\n    else if (typeof v === \"number\" || typeof v === \"boolean\")\n      out[k] = String(v);\n    else warnings.push(`\"${name}\".${field}.${k} 不是字符串，已忽略`);\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\n/**\n * 归一化单条 MCP 配置。\n * @param raw 原始条目（数组元素或 mcpServers 映射的值）\n * @param fallbackName mcpServers 映射的键名\n * @returns 合法配置；无法解析时返回 null（原因写入 warnings）\n */\nexport function normalizeMcpConfig(\n  raw: unknown,\n  fallbackName?: string,\n  opts: McpConfigNormalizeOptions = {},\n  warnings: string[] = [],\n): McpServerConfig | null {\n  const env = opts.env ?? process.env;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    warnings.push(`MCP 配置条目${fallbackName ? ` \"${fallbackName}\"` : \"\"} 不是对象，已跳过`);\n    return null;\n  }\n  const o = raw as Record<string, unknown>;\n  const name =\n    typeof o.name === \"string\" && o.name.trim()\n      ? o.name.trim()\n      : fallbackName?.trim();\n  if (!name) {\n    warnings.push(\"MCP 配置缺少 name，已跳过\");\n    return null;\n  }\n\n  const rawType = typeof o.type === \"string\" ? o.type.toLowerCase() : \"\";\n  let type: McpTransportType | undefined;\n  if (TRANSPORT_TYPES.has(rawType)) type = rawType as McpTransportType;\n  else if (rawType === \"streamable-http\" || rawType === \"streamablehttp\")\n    type = \"http\";\n  else if (typeof o.builtin === \"string\") type = \"builtin\";\n  else if (typeof o.url === \"string\")\n    type = /\\/sse(?:[?#]|$)/i.test(o.url) ? \"sse\" : \"http\";\n  else if (o.command !== undefined) type = \"stdio\";\n\n  if (!type) {\n    warnings.push(`MCP \"${name}\" 无法推断传输类型（需要 builtin/command/url）`);\n    return null;\n  }\n\n  const enabled =\n    o.enabled === false || o.disabled === true ? false : true;\n  const config: McpServerConfig = { name, type, enabled };\n\n  if (type === \"stdio\") {\n    const command: string[] = [];\n    if (Array.isArray(o.command)) {\n      for (const part of o.command) {\n        if (typeof part === \"string\") command.push(part);\n        else warnings.push(`MCP \"${name}\" 的 command 含非字符串项，已忽略`);\n      }\n    } else if (typeof o.command === \"string\") {\n      command.push(...splitCommandLine(o.command));\n    }\n    if (Array.isArray(o.args)) {\n      for (const part of o.args) {\n        if (typeof part === \"string\") command.push(part);\n        else warnings.push(`MCP \"${name}\" 的 args 含非字符串项，已忽略`);\n      }\n    } else if (typeof o.args === \"string\") {\n      command.push(...splitCommandLine(o.args));\n    }\n    if (command.length === 0) {\n      warnings.push(`MCP \"${name}\" 缺少 command，已跳过`);\n      return null;\n    }\n    config.command = command.map((c) => expandEnv(c, env, name, warnings));\n    if (typeof o.cwd === \"string\" && o.cwd.trim())\n      config.cwd = expandEnv(o.cwd, env, name, warnings);\n    const stdioEnv = toStringMap(o.env, \"env\", name, env, warnings);\n    if (stdioEnv) config.env = stdioEnv;\n  } else if (type === \"builtin\") {\n    config.builtin =\n      typeof o.builtin === \"string\" && o.builtin.trim()\n        ? o.builtin.trim()\n        : name;\n  } else {\n    if (typeof o.url !== \"string\" || !o.url.trim()) {\n      warnings.push(`MCP \"${name}\" 缺少 url，已跳过`);\n      return null;\n    }\n    config.url = expandEnv(o.url.trim(), env, name, warnings);\n    const headers = toStringMap(o.headers, \"headers\", name, env, warnings);\n    if (headers) config.headers = headers;\n  }\n\n  return config;\n}\n\n/** 归一化任意受支持的配置形状 */\nexport function normalizeMcpConfigs(\n  raw: unknown,\n  opts: McpConfigNormalizeOptions = {},\n): McpConfigNormalizeResult {\n  const warnings: string[] = [];\n  const configs: McpServerConfig[] = [];\n\n  const add = (item: unknown, fallbackName?: string): void => {\n    const cfg = normalizeMcpConfig(item, fallbackName, opts, warnings);\n    if (!cfg) return;\n    const idx = configs.findIndex((c) => c.name === cfg.name);\n    if (idx >= 0) {\n      warnings.push(`MCP \"${cfg.name}\" 重复出现，后者覆盖前者`);\n      configs[idx] = cfg;\n    } else {\n      configs.push(cfg);\n    }\n  };\n\n  if (Array.isArray(raw)) {\n    for (const item of raw) add(item);\n  } else if (raw && typeof raw === \"object\") {\n    const o = raw as Record<string, unknown>;\n    const objectMap = (value: unknown): boolean => {\n      if (!value || typeof value !== \"object\" || Array.isArray(value))\n        return false;\n      for (const [k, v] of Object.entries(value as Record<string, unknown>))\n        add(v, k);\n      return true;\n    };\n    if (Array.isArray(o.servers)) {\n      for (const item of o.servers) add(item);\n    } else if (Array.isArray(o.mcpServers)) {\n      for (const item of o.mcpServers) add(item);\n    } else if (objectMap(o.mcpServers)) {\n      // Claude Desktop / Cursor: { mcpServers: { name: { command, args } } }\n    } else if (objectMap(o.servers)) {\n      // { servers: { name: {...} } }\n    } else {\n      // 单条配置对象\n      add(o);\n    }\n  } else {\n    warnings.push(\"MCP 配置必须是 JSON 对象或数组\");\n  }\n\n  return { configs, warnings };\n}\n\n/**\n * 读取配置文件并归一化。文件不存在时返回空结果（不视为错误）。\n * @param file 配置文件路径；未提供时返回空结果\n */\nexport function readMcpConfigFile(\n  file: string | undefined,\n  opts: McpConfigNormalizeOptions = {},\n): McpConfigNormalizeResult {\n  if (!file) return { configs: [], warnings: [] };\n  try {\n    if (!fs.existsSync(file)) return { configs: [], warnings: [] };\n    const raw: unknown = JSON.parse(fs.readFileSync(file, \"utf8\"));\n    return normalizeMcpConfigs(raw, opts);\n  } catch (err) {\n    return {\n      configs: [],\n      warnings: [`读取 MCP 配置失败 ${file}: ${(err as Error).message}`],\n    };\n  }\n}\n\n/** 保存配置（统一写为数组格式，自动创建目录） */\nexport function saveMcpConfigFile(\n  file: string,\n  configs: McpServerConfig[],\n): void {\n  fs.mkdirSync(path.dirname(file), { recursive: true });\n  fs.writeFileSync(\n    file,\n    JSON.stringify(\n      configs.map((c) => JSON.parse(JSON.stringify(c)) as McpServerConfig),\n      null,\n      2,\n    ) + \"\\n\",\n    \"utf8\",\n  );\n}\n\n/** 追加内置默认配置（同名用户配置优先） */\nexport function withBuiltinMcpConfigs(\n  configs: McpServerConfig[],\n): McpServerConfig[] {\n  const existing = new Set(configs.map((c) => c.name));\n  const builtin = BUILTIN_MCP_CONFIGS.filter((c) => !existing.has(c.name)).map(\n    (c) => ({ ...c }),\n  );\n  return [...configs, ...builtin];\n}\n\n/** 读取配置文件并追加内置默认配置 */\nexport function loadMcpConfigFile(\n  file: string | undefined,\n  opts: McpConfigNormalizeOptions = {},\n): McpConfigNormalizeResult {\n  const result = readMcpConfigFile(file, opts);\n  return { configs: withBuiltinMcpConfigs(result.configs), warnings: result.warnings };\n}\n"],"mappings":"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","names":[]}

package/dist/internal/mcp/presets.cjs

@@ -0,0 +1,184 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/mcp/presets.ts
+var presets_exports = {};
+__export(presets_exports, {
+  MCP_PRESETS: () => MCP_PRESETS,
+  applyMcpPreset: () => applyMcpPreset
+});
+module.exports = __toCommonJS(presets_exports);
+var MCP_PRESETS = [
+  {
+    id: "filesystem",
+    title: "Filesystem\uFF08\u672C\u5730\u6587\u4EF6\uFF09",
+    description: "\u8BA9 MCP \u8BFB\u5199\u6307\u5B9A\u76EE\u5F55\uFF0Cnpx \u81EA\u52A8\u62C9\u53D6\u5B98\u65B9 server",
+    config: {
+      name: "filesystem",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "{{dir}}"
+      ],
+      enabled: true
+    },
+    fields: [
+      {
+        key: "dir",
+        label: "\u5141\u8BB8\u8BBF\u95EE\u7684\u76EE\u5F55\uFF08\u7EDD\u5BF9\u8DEF\u5F84\uFF09",
+        required: true
+      }
+    ]
+  },
+  {
+    id: "memory",
+    title: "Memory\uFF08\u77E5\u8BC6\u56FE\u8C31\u8BB0\u5FC6\uFF09",
+    description: "\u5B98\u65B9 memory server\uFF0C\u63D0\u4F9B\u5B9E\u4F53/\u5173\u7CFB\u8BB0\u5FC6",
+    config: {
+      name: "memory",
+      type: "stdio",
+      command: ["npx", "-y", "@modelcontextprotocol/server-memory"],
+      enabled: true
+    }
+  },
+  {
+    id: "sequential-thinking",
+    title: "Sequential Thinking\uFF08\u5206\u6B65\u63A8\u7406\uFF09",
+    description: "\u5B98\u65B9\u5206\u6B65\u601D\u8003 server",
+    config: {
+      name: "sequential-thinking",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ],
+      enabled: true
+    }
+  },
+  {
+    id: "github",
+    title: "GitHub",
+    description: "\u5B98\u65B9 GitHub server\uFF08\u9700\u8981 Personal Access Token\uFF09",
+    config: {
+      name: "github",
+      type: "stdio",
+      command: ["npx", "-y", "@modelcontextprotocol/server-github"],
+      env: { GITHUB_PERSONAL_ACCESS_TOKEN: "{{token}}" },
+      enabled: true
+    },
+    fields: [
+      {
+        key: "token",
+        label: "GitHub Personal Access Token",
+        required: true,
+        secret: true
+      }
+    ]
+  },
+  {
+    id: "fetch",
+    title: "Fetch\uFF08\u7F51\u9875\u6293\u53D6\uFF09",
+    description: "\u5B98\u65B9 Python server\uFF0C\u9700\u8981 uvx\uFF08pip install uv\uFF09",
+    config: {
+      name: "fetch",
+      type: "stdio",
+      command: ["uvx", "mcp-server-fetch"],
+      enabled: true
+    }
+  },
+  {
+    id: "postgres",
+    title: "PostgreSQL\uFF08\u53EA\u8BFB\u67E5\u8BE2\uFF09",
+    description: "\u5B98\u65B9 postgres server\uFF08\u9700\u8981\u8FDE\u63A5\u4E32\uFF09",
+    config: {
+      name: "postgres",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-postgres",
+        "{{dsn}}"
+      ],
+      enabled: true
+    },
+    fields: [
+      {
+        key: "dsn",
+        label: "\u8FDE\u63A5\u4E32\uFF08postgresql://user:pass@host/db\uFF09",
+        required: true,
+        secret: true
+      }
+    ]
+  },
+  {
+    id: "ocr",
+    title: "OCR\uFF08\u5185\u7F6E\uFF0C\u5F00\u7BB1\u5373\u7528\uFF09",
+    description: "\u8FDB\u7A0B\u5185 OCR\uFF1AmacOS Vision / tesseract / \u591A\u6A21\u6001\u6A21\u578B\u81EA\u52A8\u964D\u7EA7\uFF0C\u65E0\u9700\u5B89\u88C5",
+    config: {
+      name: "ocr",
+      type: "builtin",
+      builtin: "ocr",
+      enabled: true
+    }
+  }
+];
+function replacePlaceholders(value, values) {
+  return value.replace(/\{\{([A-Za-z0-9_]+)\}\}/g, (_m, key) => {
+    return values[key] ?? "";
+  });
+}
+function applyMcpPreset(preset, values) {
+  const base = preset.config;
+  const config = {
+    ...base,
+    name: base.name ?? preset.id
+  };
+  if (config.command)
+    config.command = config.command.map(
+      (c) => replacePlaceholders(c, values)
+    );
+  if (config.url) config.url = replacePlaceholders(config.url, values);
+  if (config.cwd) config.cwd = replacePlaceholders(config.cwd, values);
+  if (config.env) {
+    config.env = Object.fromEntries(
+      Object.entries(config.env).map(([k, v]) => [
+        k,
+        replacePlaceholders(v, values)
+      ])
+    );
+  }
+  if (config.headers) {
+    config.headers = Object.fromEntries(
+      Object.entries(config.headers).map(([k, v]) => [
+        k,
+        replacePlaceholders(v, values)
+      ])
+    );
+  }
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MCP_PRESETS,
+  applyMcpPreset
+});
+//# sourceMappingURL=presets.cjs.map

package/dist/internal/mcp/presets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/presets.ts"],"sourcesContent":["/**\n * MCP 安装模板\n *\n * 用于 `/mcp add` 交互式向导：把常见官方服务器的启动命令与参数固化，\n * 用户只需按提示填写少量占位符。`{{key}}` 会在安装时被替换。\n */\n\nimport type { McpServerConfig } from \"./McpClient.js\";\n\n/** 模板占位符 */\nexport interface McpPresetField {\n  /** 替换 config 中的 {{key}} */\n  key: string;\n  /** 提示文案 */\n  label: string;\n  /** 必填（为空则取消安装） */\n  required?: boolean;\n  /** 隐藏输入（写入 env/headers 的密钥） */\n  secret?: boolean;\n  /** 默认值 */\n  default?: string;\n}\n\n/** 安装模板 */\nexport interface McpPreset {\n  id: string;\n  title: string;\n  description: string;\n  /** name 缺省时使用 id */\n  config: Omit<McpServerConfig, \"name\"> & { name?: string };\n  fields?: McpPresetField[];\n}\n\n/** 内置模板（官方服务器为主，命令与包名可被用户覆盖） */\nexport const MCP_PRESETS: McpPreset[] = [\n  {\n    id: \"filesystem\",\n    title: \"Filesystem（本地文件）\",\n    description: \"让 MCP 读写指定目录，npx 自动拉取官方 server\",\n    config: {\n      name: \"filesystem\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-filesystem\",\n        \"{{dir}}\",\n      ],\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"dir\",\n        label: \"允许访问的目录（绝对路径）\",\n        required: true,\n      },\n    ],\n  },\n  {\n    id: \"memory\",\n    title: \"Memory（知识图谱记忆）\",\n    description: \"官方 memory server，提供实体/关系记忆\",\n    config: {\n      name: \"memory\",\n      type: \"stdio\",\n      command: [\"npx\", \"-y\", \"@modelcontextprotocol/server-memory\"],\n      enabled: true,\n    },\n  },\n  {\n    id: \"sequential-thinking\",\n    title: \"Sequential Thinking（分步推理）\",\n    description: \"官方分步思考 server\",\n    config: {\n      name: \"sequential-thinking\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-sequential-thinking\",\n      ],\n      enabled: true,\n    },\n  },\n  {\n    id: \"github\",\n    title: \"GitHub\",\n    description: \"官方 GitHub server（需要 Personal Access Token）\",\n    config: {\n      name: \"github\",\n      type: \"stdio\",\n      command: [\"npx\", \"-y\", \"@modelcontextprotocol/server-github\"],\n      env: { GITHUB_PERSONAL_ACCESS_TOKEN: \"{{token}}\" },\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"token\",\n        label: \"GitHub Personal Access Token\",\n        required: true,\n        secret: true,\n      },\n    ],\n  },\n  {\n    id: \"fetch\",\n    title: \"Fetch（网页抓取）\",\n    description: \"官方 Python server，需要 uvx（pip install uv）\",\n    config: {\n      name: \"fetch\",\n      type: \"stdio\",\n      command: [\"uvx\", \"mcp-server-fetch\"],\n      enabled: true,\n    },\n  },\n  {\n    id: \"postgres\",\n    title: \"PostgreSQL（只读查询）\",\n    description: \"官方 postgres server（需要连接串）\",\n    config: {\n      name: \"postgres\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-postgres\",\n        \"{{dsn}}\",\n      ],\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"dsn\",\n        label: \"连接串（postgresql://user:pass@host/db）\",\n        required: true,\n        secret: true,\n      },\n    ],\n  },\n  {\n    id: \"ocr\",\n    title: \"OCR（内置，开箱即用）\",\n    description:\n      \"进程内 OCR：macOS Vision / tesseract / 多模态模型自动降级，无需安装\",\n    config: {\n      name: \"ocr\",\n      type: \"builtin\",\n      builtin: \"ocr\",\n      enabled: true,\n    },\n  },\n];\n\nfunction replacePlaceholders(\n  value: string,\n  values: Record<string, string>,\n): string {\n  return value.replace(/\\{\\{([A-Za-z0-9_]+)\\}\\}/g, (_m, key: string) => {\n    return values[key] ?? \"\";\n  });\n}\n\n/** 用填写的占位符生成最终配置（不会修改模板对象） */\nexport function applyMcpPreset(\n  preset: McpPreset,\n  values: Record<string, string>,\n): McpServerConfig {\n  const base = preset.config;\n  const config: McpServerConfig = {\n    ...base,\n    name: base.name ?? preset.id,\n  };\n  if (config.command)\n    config.command = config.command.map((c) =>\n      replacePlaceholders(c, values),\n    );\n  if (config.url) config.url = replacePlaceholders(config.url, values);\n  if (config.cwd) config.cwd = replacePlaceholders(config.cwd, values);\n  if (config.env) {\n    config.env = Object.fromEntries(\n      Object.entries(config.env).map(([k, v]) => [\n        k,\n        replacePlaceholders(v, values),\n      ]),\n    );\n  }\n  if (config.headers) {\n    config.headers = Object.fromEntries(\n      Object.entries(config.headers).map(([k, v]) => [\n        k,\n        replacePlaceholders(v, values),\n      ]),\n    );\n  }\n  return config;\n}\n"],"mappings":"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","names":[]}

package/dist/internal/mcp/presets.d.cts

@@ -0,0 +1,39 @@
+import { a as McpServerConfig } from '../../McpClient-CEQBUPuC.cjs';
+
+/**
+ * MCP 安装模板
+ *
+ * 用于 `/mcp add` 交互式向导：把常见官方服务器的启动命令与参数固化，
+ * 用户只需按提示填写少量占位符。`{{key}}` 会在安装时被替换。
+ */
+
+/** 模板占位符 */
+interface McpPresetField {
+    /** 替换 config 中的 {{key}} */
+    key: string;
+    /** 提示文案 */
+    label: string;
+    /** 必填（为空则取消安装） */
+    required?: boolean;
+    /** 隐藏输入（写入 env/headers 的密钥） */
+    secret?: boolean;
+    /** 默认值 */
+    default?: string;
+}
+/** 安装模板 */
+interface McpPreset {
+    id: string;
+    title: string;
+    description: string;
+    /** name 缺省时使用 id */
+    config: Omit<McpServerConfig, "name"> & {
+        name?: string;
+    };
+    fields?: McpPresetField[];
+}
+/** 内置模板（官方服务器为主，命令与包名可被用户覆盖） */
+declare const MCP_PRESETS: McpPreset[];
+/** 用填写的占位符生成最终配置（不会修改模板对象） */
+declare function applyMcpPreset(preset: McpPreset, values: Record<string, string>): McpServerConfig;
+
+export { MCP_PRESETS, type McpPreset, type McpPresetField, applyMcpPreset };

package/dist/internal/mcp/presets.d.ts

@@ -0,0 +1,39 @@
+import { a as McpServerConfig } from '../../McpClient-CEQBUPuC.js';
+
+/**
+ * MCP 安装模板
+ *
+ * 用于 `/mcp add` 交互式向导：把常见官方服务器的启动命令与参数固化，
+ * 用户只需按提示填写少量占位符。`{{key}}` 会在安装时被替换。
+ */
+
+/** 模板占位符 */
+interface McpPresetField {
+    /** 替换 config 中的 {{key}} */
+    key: string;
+    /** 提示文案 */
+    label: string;
+    /** 必填（为空则取消安装） */
+    required?: boolean;
+    /** 隐藏输入（写入 env/headers 的密钥） */
+    secret?: boolean;
+    /** 默认值 */
+    default?: string;
+}
+/** 安装模板 */
+interface McpPreset {
+    id: string;
+    title: string;
+    description: string;
+    /** name 缺省时使用 id */
+    config: Omit<McpServerConfig, "name"> & {
+        name?: string;
+    };
+    fields?: McpPresetField[];
+}
+/** 内置模板（官方服务器为主，命令与包名可被用户覆盖） */
+declare const MCP_PRESETS: McpPreset[];
+/** 用填写的占位符生成最终配置（不会修改模板对象） */
+declare function applyMcpPreset(preset: McpPreset, values: Record<string, string>): McpServerConfig;
+
+export { MCP_PRESETS, type McpPreset, type McpPresetField, applyMcpPreset };