mcp-xdx-schema-ctx 1.1.9

package/dist/tool-availability.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 工具可用性推导 — 纯函数，不依赖数据库/连接池，便于离线单元测试。
+ *
+ * 输入：环境库元数据表存在性 + 用户库表存在性 + 用户库可达性。
+ * 输出：每个 A 侧工具的 { available, requires, userRequires, missing, userMissing, reason?, fallback? }。
+ *
+ * 关键区分：环境库(元数据)表与用户库(业务)表必须分开探测。
+ * 例如 get_sys_dict 依赖的是**用户库**的 SysDbType/SyDbValue，若按环境库探测会误判为不可用。
+ */
+export interface CapabilityProbe {
+    /** 环境库元数据表名 -> 是否存在（如 "TableSetTB"） */
+    tables: Record<string, boolean>;
+    /** 用户库表名 -> 是否存在（如 "SysDbType"）；未配置用户库时可为空对象 */
+    userTables?: Record<string, boolean>;
+    userDbConfigured: boolean;
+    userDbReachable: boolean;
+}
+export interface ToolCapability {
+    tool: string;
+    available: boolean;
+    /** 依赖的环境库元数据表（物理名） */
+    requires: string[];
+    /** 依赖的用户库表（物理名） */
+    userRequires: string[];
+    /** 环境库缺失的表 */
+    missing: string[];
+    /** 用户库缺失的表 */
+    userMissing: string[];
+    needsUserDb: boolean;
+    reason?: string;
+    fallback?: string;
+}
+/** 全部需要探测的用户库表（供 get_capabilities 预取） */
+export declare const USER_DB_PROBE_TABLES: string[];
+export declare function computeToolAvailability(probe: CapabilityProbe): ToolCapability[];

package/dist/tool-availability.js

@@ -0,0 +1,90 @@
+/**
+ * 工具可用性推导 — 纯函数，不依赖数据库/连接池，便于离线单元测试。
+ *
+ * 输入：环境库元数据表存在性 + 用户库表存在性 + 用户库可达性。
+ * 输出：每个 A 侧工具的 { available, requires, userRequires, missing, userMissing, reason?, fallback? }。
+ *
+ * 关键区分：环境库(元数据)表与用户库(业务)表必须分开探测。
+ * 例如 get_sys_dict 依赖的是**用户库**的 SysDbType/SyDbValue，若按环境库探测会误判为不可用。
+ */
+/**
+ * A 侧工具 → 依赖的表。
+ * - requires / userRequires 为空 = 仅依赖 INFORMATION_SCHEMA / 自身逻辑，永远可用；
+ * - needsUserDb = 需要用户库（DB_TARGET_DATABASES）可达；
+ * - 只列"硬依赖"，可选子表不列入（工具内部已按模块降级）。
+ */
+const TOOL_SPECS = [
+    { tool: "list_tables", requires: ["TableSetTB"], fallback: "list_tables(scope=system)" },
+    { tool: "describe_table", requires: [], fallback: "describe_table" },
+    { tool: "search_schema", requires: ["TableSetTB", "TableFieldSetTB"], fallback: "list_tables" },
+    { tool: "get_table_relations", requires: ["TableSetTB"], fallback: "describe_table" },
+    { tool: "check_user_table", requires: [], needsUserDb: true, fallback: "get_capabilities" },
+    { tool: "get_table_indexes", requires: [], needsUserDb: true, fallback: "get_capabilities" },
+    { tool: "suggest_indexes", requires: ["TableFieldSetTB"], fallback: "describe_table" },
+    { tool: "get_virtual_tables", requires: ["VirtualTableTB"], fallback: "get_capabilities" },
+    { tool: "get_module_tree", requires: ["ModuleManageTB"], fallback: "get_capabilities" },
+    { tool: "get_inoutkind_detail", requires: ["InOutKindTB"], fallback: "query_table_data" },
+    { tool: "resolve_table", requires: ["TableSetTB"], fallback: "describe_table" },
+    { tool: "query_table_data", requires: [], fallback: "describe_table" },
+    { tool: "list_forms", requires: ["FormSetTB"], fallback: "get_capabilities" },
+    { tool: "get_form", requires: ["FormSetTB"], fallback: "get_capabilities" },
+    { tool: "get_form_full", requires: ["FormSetTB"], fallback: "get_form" },
+    { tool: "get_user_form_schemes", requires: ["UserFormSetHedTB"], fallback: "get_form_full" },
+    { tool: "get_dbo_detail", requires: ["DBOSetTB"], fallback: "get_capabilities" },
+    { tool: "trace_dataflow", requires: ["DataFlowHedTB"], fallback: "get_capabilities" },
+    { tool: "get_data_source_full", requires: ["DataSourceSetHedTB"], fallback: "get_capabilities" },
+    { tool: "get_transfer_rules", requires: ["TransferRuleHedTB"], fallback: "get_capabilities" },
+    { tool: "get_function_tree", requires: ["FunctionTB"], fallback: "get_capabilities" },
+    { tool: "get_page_actions", requires: ["MenuFunction"], fallback: "get_capabilities" },
+    { tool: "get_choose_ui_detail", requires: ["ChooseUISetTB"], fallback: "get_capabilities" },
+    { tool: "get_button_detail", requires: ["ButtonTB"], fallback: "get_capabilities" },
+    { tool: "get_system_enums", requires: ["LinkTypeTB"], fallback: "get_sys_dict" },
+    {
+        tool: "get_sys_dict",
+        requires: [],
+        userRequires: ["SysDbType", "SyDbValue"],
+        needsUserDb: true,
+        fallback: "get_capabilities",
+    },
+    { tool: "get_db_object_source", requires: [], needsUserDb: true, fallback: "get_capabilities" },
+    { tool: "get_view_lineage", requires: [], needsUserDb: true, fallback: "get_db_object_source" },
+    { tool: "get_capabilities", requires: [], fallback: "get_capabilities" },
+];
+/** 全部需要探测的用户库表（供 get_capabilities 预取） */
+export const USER_DB_PROBE_TABLES = [
+    ...new Set(TOOL_SPECS.flatMap((s) => s.userRequires ?? [])),
+];
+export function computeToolAvailability(probe) {
+    const userOk = probe.userDbConfigured && probe.userDbReachable;
+    const userTables = probe.userTables ?? {};
+    return TOOL_SPECS.map((spec) => {
+        const userRequires = spec.userRequires ?? [];
+        const missing = spec.requires.filter((t) => !probe.tables[t]);
+        const userMissing = userRequires.filter((t) => !userTables[t]);
+        const needsUserDb = spec.needsUserDb === true;
+        const userDbProblem = needsUserDb && !userOk;
+        const available = missing.length === 0 && userMissing.length === 0 && !userDbProblem;
+        const reasonParts = [];
+        if (missing.length > 0)
+            reasonParts.push(`环境库缺少 ${missing.join(", ")}`);
+        if (userMissing.length > 0)
+            reasonParts.push(`用户库缺少 ${userMissing.join(", ")}`);
+        if (userDbProblem)
+            reasonParts.push(probe.userDbConfigured
+                ? "用户库不可达（请检查 DB_TARGET_DATABASES / 权限）"
+                : "未配置用户库（DB_TARGET_DATABASES 为空）");
+        return {
+            tool: spec.tool,
+            available,
+            requires: spec.requires,
+            userRequires,
+            missing,
+            userMissing,
+            needsUserDb,
+            ...(available
+                ? {}
+                : { reason: reasonParts.join("；"), fallback: spec.fallback }),
+        };
+    });
+}
+//# sourceMappingURL=tool-availability.js.map

package/dist/tool-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.js","sourceRoot":"","sources":["../src/tool-availability.ts"],"names":[],"mappings":"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"}

package/dist/tools/data-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDataTools(server: McpServer): void;

package/dist/tools/data-tools.js

@@ -0,0 +1,243 @@
+import { z } from "zod";
+import { envDb, table, queryWithParams } from "../db.js";
+import { env } from "../config.js";
+import { WARNING, envelope, ok, topNPagination, userName } from "../shared.js";
+import { getTableColumns, hasCol, pickCols, tableExists, tryQuery, userTableExists, } from "../schema-compat.js";
+import { buildDataQuery, buildWhere, maskRow, DATA_QUERY_MAX_TOP, } from "../sql-build.js";
+/** 文本类列（用于 keyword 模糊搜索） */
+const TEXT_TYPE = /char|text|xml|uniqueidentifier/i;
+export function registerDataTools(server) {
+    // ============================================================
+    // query_table_data — 只读查询表数据（值参数化，敏感列默认脱敏）
+    // ============================================================
+    server.registerTool("query_table_data", {
+        description: WARNING +
+            "\n\n【只读查数据】查询一张表的数据行，用于回答「某字段值是什么」类问题。\n" +
+            "安全边界：只读守卫 + TOP≤200 + 语句超时 + 列名白名单（来自实际 schema）+ 值参数化 + 敏感列默认脱敏；禁止任意 SQL。\n" +
+            "表解析顺序：用户库 → 环境库 → 都未命中则返回 TableSetTB 中的模糊候选。",
+        inputSchema: {
+            tableName: z.string().max(128).describe("表名，如 MoveKindTB"),
+            columns: z
+                .string()
+                .max(1000)
+                .optional()
+                .describe("要返回的列，逗号分隔；缺省返回全部列"),
+            filter: z
+                .array(z.object({
+                column: z.string().max(128).describe("列名"),
+                op: z.enum(["eq", "like", "in"]).describe("比较方式"),
+                value: z
+                    .union([z.string(), z.array(z.string())])
+                    .describe("值；op=in 时传数组"),
+            }))
+                .max(20)
+                .optional()
+                .describe("过滤条件（组间 AND）"),
+            keyword: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("在文本列之间做 OR 模糊搜索"),
+            orderBy: z.string().max(128).optional().describe("排序列名"),
+            orderDir: z.enum(["ASC", "DESC"]).optional().default("ASC").describe("排序方向"),
+            top: z
+                .number()
+                .int()
+                .min(1)
+                .max(DATA_QUERY_MAX_TOP)
+                .default(20)
+                .describe(`返回行数上限（1..${DATA_QUERY_MAX_TOP}，默认 20）`),
+            mask: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("是否对敏感列脱敏（默认 true）"),
+        },
+    }, async ({ tableName, columns, filter, keyword, orderBy, orderDir = "ASC", top = 20, mask = true, }) => {
+        const warnings = [];
+        const safeName = tableName.replace(/[^a-zA-Z0-9_]/g, "");
+        if (!safeName) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "query_table_data",
+                        message: `表名 "${tableName}" 非法（仅允许字母/数字/下划线）`,
+                    },
+                ],
+                table: tableName,
+                resolved: false,
+            }));
+        }
+        // ---- 1) 解析表所在库：用户库 → 环境库 ----
+        let db = "";
+        if (userName && (await userTableExists(userName, safeName))) {
+            db = userName;
+        }
+        else if (await tableExists(table(envDb(), safeName))) {
+            db = envDb();
+        }
+        if (!db) {
+            // 未命中 → 返回 TableSetTB 中的模糊候选，便于定位
+            let candidates = [];
+            if (await tableExists(table(envDb(), "TableSetTB"))) {
+                const tCols = await getTableColumns(table(envDb(), "TableSetTB"));
+                const filters = [
+                    { col: "TableName", op: "like", value: safeName },
+                    { col: "TableDesc", op: "like", value: tableName },
+                ].filter((f) => hasCol(tCols, f.col));
+                if (filters.length > 0) {
+                    const { where } = buildWhere(tCols, [{ logic: "or", filters }]);
+                    if (where) {
+                        const sel = pickCols(tCols, ["TableName", "TableDesc", "TableType"]);
+                        candidates = await tryQuery("query_table_data.candidates", `SELECT TOP 10 ${sel.map((c) => `[${c}]`).join(", ")} FROM ${table(envDb(), "TableSetTB")}${where}`, warnings);
+                    }
+                }
+            }
+            warnings.push({
+                module: "query_table_data",
+                message: `表 "${tableName}" 在用户库/环境库中都不存在`,
+                hint: "可用 resolve_table(nameOrKeyword=...) 或 list_tables(keyword=...) 定位",
+                fallback: "resolve_table",
+            });
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings,
+                table: safeName,
+                resolved: false,
+                candidates,
+            }));
+        }
+        // ---- 2) 实际列（原始大小写 + 类型） ----
+        const colRows = await tryQuery("query_table_data.columns", `SELECT COLUMN_NAME, DATA_TYPE FROM [${db}].INFORMATION_SCHEMA.COLUMNS ` +
+            `WHERE TABLE_SCHEMA='dbo' AND TABLE_NAME='${safeName}' ORDER BY ORDINAL_POSITION`, warnings);
+        const physical = colRows.map((r) => String(r.COLUMN_NAME));
+        if (physical.length === 0) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "query_table_data",
+                        message: `无法读取 ${db}.${safeName} 的列定义`,
+                    },
+                ],
+                table: safeName,
+                db,
+                resolved: false,
+            }));
+        }
+        const allCols = new Set(physical.map((c) => c.toUpperCase()));
+        const textCols = colRows
+            .filter((r) => TEXT_TYPE.test(String(r.DATA_TYPE)))
+            .map((r) => String(r.COLUMN_NAME));
+        // ---- 3) 选择列（白名单）+ 无效列名候选建议 ----
+        let wanted;
+        let columnSuggestions = [];
+        if (columns) {
+            const requested = columns
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => /^[A-Za-z0-9_]+$/.test(s));
+            const invalid = requested.filter((c) => !hasCol(allCols, c));
+            wanted = requested.filter((c) => hasCol(allCols, c));
+            if (invalid.length > 0) {
+                // 按名称子串/前缀给出候选列；无匹配则回退前 30 列
+                columnSuggestions = invalid.map((req) => {
+                    const r = req.toLowerCase();
+                    let sug = physical.filter((c) => c.toLowerCase().includes(r));
+                    if (sug.length === 0 && r.length >= 3) {
+                        sug = physical.filter((c) => c.toLowerCase().includes(r.slice(0, 3)));
+                    }
+                    if (sug.length === 0)
+                        sug = physical.slice(0, 30);
+                    return { requested: req, suggestions: sug.slice(0, 20) };
+                });
+                warnings.push({
+                    module: "query_table_data",
+                    message: `以下列在本表不存在，已忽略: ${invalid.join(", ")}`,
+                    hint: "见 columnSuggestions / availableColumns 候选列名；可用 describe_table 查看完整字段",
+                });
+            }
+        }
+        else {
+            wanted = physical;
+        }
+        if (wanted.length === 0) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "query_table_data",
+                        message: "没有可查询的列（columns 全部无效）",
+                        hint: "见 columnSuggestions / availableColumns 候选列名",
+                    },
+                ],
+                table: safeName,
+                db,
+                resolved: true,
+                availableColumns: physical.slice(0, 200),
+                columnSuggestions,
+            }));
+        }
+        // ---- 4) 构造并执行参数化查询 ----
+        const built = buildDataQuery({
+            table: table(db, safeName),
+            cols: wanted,
+            filters: (filter ?? []).map((f) => ({
+                col: f.column,
+                op: f.op,
+                value: f.value,
+            })),
+            keyword: keyword && textCols.length > 0
+                ? { value: keyword, cols: textCols }
+                : undefined,
+            orderBy: orderBy ? { col: orderBy, dir: orderDir } : undefined,
+            top,
+        });
+        if (built.skipped.length > 0) {
+            warnings.push({
+                module: "query_table_data",
+                message: `以下过滤/排序列无效或不存在，已跳过: ${built.skipped.join(", ")}`,
+            });
+        }
+        let items = [];
+        try {
+            items = await queryWithParams(built.sql, built.params);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            warnings.push({
+                module: "query_table_data",
+                message,
+                hint: "可用 describe_table 查看实际字段，或缩小过滤范围后重试",
+                fallback: "describe_table",
+            });
+        }
+        // ---- 5) 敏感列脱敏 ----
+        let maskedColumns = [];
+        if (mask && items.length > 0) {
+            const masked = items.map((r) => maskRow(r, env.DB_SENSITIVE_COLUMNS));
+            items = masked.map((m) => m.row);
+            maskedColumns = [...new Set(masked.flatMap((m) => m.maskedColumns))];
+        }
+        const limit = Math.min(DATA_QUERY_MAX_TOP, Math.max(1, top));
+        return ok(envelope({
+            items,
+            pagination: topNPagination(limit, items.length),
+            warnings,
+            table: safeName,
+            db,
+            resolved: true,
+            columns: wanted,
+            availableColumns: physical.slice(0, 200),
+            columnSuggestions,
+            maskedColumns,
+            appliedFilters: built.applied,
+        }));
+    });
+}
+//# sourceMappingURL=data-tools.js.map

package/dist/tools/data-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-tools.js","sourceRoot":"","sources":["../../src/tools/data-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/dataflow-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDataflowTools(server: McpServer): void;