redash-mcp 3.1.3 → 3.1.4

package/manifest.json

@@ -1,8 +1,9 @@
 {
   "manifest_version": "0.3",
   "name": "redash-mcp",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "description": "MCP server for Redash -- query data, manage dashboards, and run SQL with natural language. 24 tools including BIRD SQL methodology.",
+  "long_description": "Connects an MCP client to a Redash instance: list data sources, inspect schemas, run SQL, manage saved queries / dashboards / alerts, and use BIRD SQL helpers (smart_query, keyword maps, few-shot examples, feedback, evaluation). Built-in SQL safety guards flag PII access and expensive scans; safety mode can be tuned per install. **Third-party data flow:** if you also set ANTHROPIC_API_KEY in the shell environment, the BIRD smart_query tool may send table-name lists (never query results or row data) to the Anthropic API as a fallback for table selection. Leave ANTHROPIC_API_KEY unset to disable this entirely.",
   "icon": "icon.png",
   "author": {
     "name": "seob717",
@@ -25,7 +26,10 @@
       "args": ["-y", "redash-mcp"],
       "env": {
         "REDASH_URL": "${user_config.redash_url}",
-        "REDASH_API_KEY": "${user_config.redash_api_key}"
+        "REDASH_API_KEY": "${user_config.redash_api_key}",
+        "REDASH_SAFETY_MODE": "${user_config.safety_mode}",
+        "REDASH_SAFETY_DISABLE_PII": "${user_config.disable_pii_guard}",
+        "REDASH_SAFETY_DISABLE_COST": "${user_config.disable_cost_guard}"
       }
     }
   },
@@ -42,6 +46,27 @@
       "description": "Your Redash user API key (found in Settings > Account)",
       "sensitive": true,
       "required": true
+    },
+    "safety_mode": {
+      "type": "string",
+      "title": "SQL Safety Mode",
+      "description": "How strictly to enforce SQL safety guards. 'strict' blocks risky queries (DELETE without WHERE, full table scans on large tables, PII access). 'warn' (default) returns warnings but executes the query. 'off' disables all guards -- not recommended.",
+      "default": "warn",
+      "required": false
+    },
+    "disable_pii_guard": {
+      "type": "boolean",
+      "title": "Disable PII guard (NOT RECOMMENDED)",
+      "description": "Only enable if you understand the consequences. When enabled, queries that read columns flagged as PII (email, phone, ssn, etc.) will not be warned about or blocked.",
+      "default": false,
+      "required": false
+    },
+    "disable_cost_guard": {
+      "type": "boolean",
+      "title": "Disable cost guard (NOT RECOMMENDED)",
+      "description": "Only enable if you understand the consequences. When enabled, expensive queries (full scans, large cross joins) will not be warned about or blocked.",
+      "default": false,
+      "required": false
     }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "redash-mcp",
   "mcpName": "io.github.seob717/redash-mcp",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "description": "MCP server for Redash",
   "license": "MIT",
   "author": "seob717",
@@ -14,7 +14,7 @@
     "model-context-protocol"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "repository": {
     "type": "git",
@@ -30,7 +30,8 @@
     "redash-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && node scripts/build.mjs",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "vitest run",
@@ -44,6 +45,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "esbuild": "^0.27.7",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.6"

package/dist/bird/complexity.js

@@ -1,87 +0,0 @@
-export function assessComplexity(question, prunedTables) {
-    let score = 0;
-    const hints = [];
-    const reasons = [];
-    const q = question.toLowerCase();
-    const relevantTables = prunedTables.filter((t) => t.score > 0).length;
-    if (relevantTables > 1) {
-        score += (relevantTables - 1) * 2;
-        reasons.push(`${relevantTables} tables involved`);
-    }
-    const joinKeywords = ["join", "combine", "relate", "between tables", "연결", "결합", "조인"];
-    if (joinKeywords.some((kw) => q.includes(kw))) {
-        score += 2;
-        reasons.push("explicit join requested");
-        hints.push("Verify JOIN conditions match the correct foreign keys.");
-    }
-    const subqueryKeywords = [
-        "for each", "among those", "within", "nested", "sub",
-        "중에서", "각각", "그중", "해당하는",
-    ];
-    if (subqueryKeywords.some((kw) => q.includes(kw))) {
-        score += 2;
-        reasons.push("subquery likely needed");
-        hints.push("Consider using CTEs for readability.");
-    }
-    const windowKeywords = [
-        "ranking", "rank", "running total", "cumulative", "previous",
-        "percentile", "top n", "nth",
-        "순위", "누적", "이전", "상위",
-    ];
-    if (windowKeywords.some((kw) => q.includes(kw))) {
-        score += 3;
-        reasons.push("window functions may be needed");
-        hints.push("Use window functions (ROW_NUMBER, RANK, LAG/LEAD) as appropriate.");
-    }
-    const pivotKeywords = [
-        "compare across", "breakdown by", "pivot", "crosstab",
-        "비교", "교차", "피벗", "대비",
-    ];
-    if (pivotKeywords.some((kw) => q.includes(kw))) {
-        score += 2;
-        reasons.push("cross-comparison or pivoting needed");
-        hints.push("Consider CASE WHEN for pivot-style queries.");
-    }
-    const timeCompareKeywords = [
-        "year over year", "month over month", "yoy", "mom",
-        "growth rate", "change rate", "trend",
-        "전년", "전월", "증감", "추이", "변화율", "성장률",
-    ];
-    if (timeCompareKeywords.some((kw) => q.includes(kw))) {
-        score += 2;
-        reasons.push("time-based comparison needed");
-        hints.push("Use LAG() or self-join for period-over-period comparisons.");
-    }
-    const ratioKeywords = [
-        "ratio", "rate", "conversion", "percentage", "proportion",
-        "비율", "전환율", "퍼센트", "점유율",
-    ];
-    if (ratioKeywords.some((kw) => q.includes(kw))) {
-        score += 1;
-        reasons.push("ratio calculation involved");
-    }
-    let level;
-    if (score <= 2) {
-        level = "simple";
-    }
-    else if (score <= 5) {
-        level = "medium";
-    }
-    else {
-        level = "complex";
-    }
-    if (level === "simple" && hints.length === 0) {
-        hints.push("Straightforward query. Focus on correct column names and filter values.");
-    }
-    if (level === "medium" && hints.length === 0) {
-        hints.push("Moderate complexity. Double-check JOIN conditions and GROUP BY columns.");
-    }
-    if (level === "complex" && hints.length === 0) {
-        hints.push("Complex query. Consider breaking into CTEs for clarity and correctness.");
-    }
-    return {
-        level,
-        reasoning: reasons.length > 0 ? reasons.join("; ") : "single table with basic filtering",
-        hints,
-    };
-}

package/dist/bird/config.js

@@ -1,73 +0,0 @@
-import { readFile, mkdir, writeFile } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import path from "node:path";
-import os from "node:os";
-const DEFAULT_CONFIG = {
-    bird: {
-        enabled: true,
-        schemaPruning: {
-            enabled: true,
-            topK: 7,
-            includeSampleValues: true,
-            maxSampleValues: 5,
-        },
-        fewShot: {
-            enabled: true,
-            maxExamplesPerQuery: 3,
-        },
-        feedback: {
-            enabled: true,
-            autoPromoteThreshold: 3,
-        },
-        complexity: {
-            enabled: true,
-        },
-    },
-};
-export function getConfigDir() {
-    return process.env.REDASH_MCP_CONFIG_DIR || path.join(os.homedir(), ".redash-mcp");
-}
-export async function ensureConfigDir() {
-    const dir = getConfigDir();
-    for (const sub of ["", "few-shot", "feedback", "eval", "keyword-map"]) {
-        const p = path.join(dir, sub);
-        if (!existsSync(p)) {
-            await mkdir(p, { recursive: true });
-        }
-    }
-}
-export function getDataSourcePath(subdir, dataSourceId) {
-    return path.join(getConfigDir(), subdir, `${dataSourceId}.json`);
-}
-export async function loadConfig() {
-    const configPath = path.join(getConfigDir(), "config.json");
-    try {
-        const raw = await readFile(configPath, "utf-8");
-        const parsed = JSON.parse(raw);
-        return deepMerge(DEFAULT_CONFIG, parsed);
-    }
-    catch {
-        return DEFAULT_CONFIG;
-    }
-}
-export async function saveConfig(config) {
-    await ensureConfigDir();
-    const configPath = path.join(getConfigDir(), "config.json");
-    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
-}
-function deepMerge(target, source) {
-    const result = { ...target };
-    for (const key of Object.keys(source)) {
-        if (source[key] &&
-            typeof source[key] === "object" &&
-            !Array.isArray(source[key]) &&
-            target[key] &&
-            typeof target[key] === "object") {
-            result[key] = deepMerge(target[key], source[key]);
-        }
-        else {
-            result[key] = source[key];
-        }
-    }
-    return result;
-}

package/dist/bird/evaluation.js

@@ -1,172 +0,0 @@
-import { readFile, writeFile } from "node:fs/promises";
-import { ensureConfigDir, getDataSourcePath } from "./config.js";
-import { redashFetch, pollQueryResult } from "../redash-client.js";
-export async function loadTestSuite(dataSourceId) {
-    try {
-        const raw = await readFile(getDataSourcePath("eval", dataSourceId), "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return { dataSourceId, testCases: [], runs: [] };
-    }
-}
-async function saveTestSuite(dataSourceId, store) {
-    await ensureConfigDir();
-    await writeFile(getDataSourcePath("eval", dataSourceId), JSON.stringify(store, null, 2), "utf-8");
-}
-export async function addTestCase(dataSourceId, testCase) {
-    const store = await loadTestSuite(dataSourceId);
-    const newCase = {
-        ...testCase,
-        id: `tc_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
-    };
-    store.testCases.push(newCase);
-    await saveTestSuite(dataSourceId, store);
-    return newCase;
-}
-export async function removeTestCase(dataSourceId, testCaseId) {
-    const store = await loadTestSuite(dataSourceId);
-    const filtered = store.testCases.filter((tc) => tc.id !== testCaseId);
-    if (filtered.length === store.testCases.length)
-        return false;
-    store.testCases = filtered;
-    await saveTestSuite(dataSourceId, store);
-    return true;
-}
-export async function runEvaluation(dataSourceId, generatedSqls) {
-    const store = await loadTestSuite(dataSourceId);
-    const results = [];
-    for (const { testCaseId, generatedSql } of generatedSqls) {
-        const testCase = store.testCases.find((tc) => tc.id === testCaseId);
-        if (!testCase) {
-            results.push({
-                testCaseId,
-                generatedSql,
-                match: false,
-                details: "Test case not found",
-            });
-            continue;
-        }
-        try {
-            const match = await compareQueryResults(dataSourceId, testCase.groundTruthSql, generatedSql);
-            results.push({
-                testCaseId,
-                generatedSql,
-                match: match.isMatch,
-                details: match.details,
-            });
-        }
-        catch (err) {
-            results.push({
-                testCaseId,
-                generatedSql,
-                match: false,
-                details: `Execution error: ${err.message}`,
-            });
-        }
-    }
-    const matchCount = results.filter((r) => r.match).length;
-    const total = results.length;
-    const byDifficulty = (level) => {
-        const relevant = generatedSqls
-            .map((gs) => ({
-            ...gs,
-            testCase: store.testCases.find((tc) => tc.id === gs.testCaseId),
-        }))
-            .filter((gs) => gs.testCase?.difficulty === level);
-        if (relevant.length === 0)
-            return 0;
-        const matches = relevant.filter((gs) => results.find((r) => r.testCaseId === gs.testCaseId)?.match).length;
-        return matches / relevant.length;
-    };
-    const run = {
-        runId: `run_${Date.now()}`,
-        timestamp: new Date().toISOString(),
-        results,
-        accuracy: {
-            overall: total > 0 ? matchCount / total : 0,
-            simple: byDifficulty("simple"),
-            medium: byDifficulty("medium"),
-            complex: byDifficulty("complex"),
-        },
-    };
-    store.runs.push(run);
-    if (store.runs.length > 10) {
-        store.runs = store.runs.slice(-10);
-    }
-    await saveTestSuite(dataSourceId, store);
-    return run;
-}
-async function compareQueryResults(dataSourceId, groundTruthSql, generatedSql) {
-    const [gtResult, genResult] = await Promise.all([
-        executeQuery(dataSourceId, groundTruthSql),
-        executeQuery(dataSourceId, generatedSql),
-    ]);
-    const gtCols = new Set(gtResult.columns);
-    const genCols = new Set(genResult.columns);
-    if (gtCols.size !== genCols.size || ![...gtCols].every((c) => genCols.has(c))) {
-        return {
-            isMatch: false,
-            details: `Column mismatch: expected [${[...gtCols].join(", ")}], got [${[...genCols].join(", ")}]`,
-        };
-    }
-    if (gtResult.rows.length !== genResult.rows.length) {
-        return {
-            isMatch: false,
-            details: `Row count mismatch: expected ${gtResult.rows.length}, got ${genResult.rows.length}`,
-        };
-    }
-    const gtSorted = sortRows(gtResult.rows, gtResult.columns);
-    const genSorted = sortRows(genResult.rows, genResult.columns);
-    for (let i = 0; i < gtSorted.length; i++) {
-        if (gtSorted[i] !== genSorted[i]) {
-            return {
-                isMatch: false,
-                details: `Data mismatch at row ${i + 1}`,
-            };
-        }
-    }
-    return { isMatch: true, details: "Exact match" };
-}
-async function executeQuery(dataSourceId, sql) {
-    const res = await redashFetch("/query_results", {
-        method: "POST",
-        body: JSON.stringify({ data_source_id: dataSourceId, query: sql, max_age: 0 }),
-    });
-    let result;
-    if (res.job) {
-        result = await pollQueryResult(res.job.id, 30);
-    }
-    else {
-        result = res;
-    }
-    const qr = result.query_result;
-    return {
-        columns: qr.data.columns.map((c) => c.name),
-        rows: qr.data.rows,
-    };
-}
-function sortRows(rows, columns) {
-    return rows
-        .map((row) => columns.map((c) => String(row[c] ?? "")).join("|"))
-        .sort();
-}
-export function formatEvalResults(run) {
-    const lines = [
-        `## Evaluation Results (${run.timestamp})`,
-        "",
-        `**Overall Accuracy**: ${(run.accuracy.overall * 100).toFixed(1)}% (${run.results.filter((r) => r.match).length}/${run.results.length})`,
-        `- Simple: ${(run.accuracy.simple * 100).toFixed(1)}%`,
-        `- Medium: ${(run.accuracy.medium * 100).toFixed(1)}%`,
-        `- Complex: ${(run.accuracy.complex * 100).toFixed(1)}%`,
-        "",
-    ];
-    const failures = run.results.filter((r) => !r.match);
-    if (failures.length > 0) {
-        lines.push("### Failed Cases:");
-        for (const f of failures) {
-            lines.push(`- **${f.testCaseId}**: ${f.details}`);
-        }
-    }
-    return lines.join("\n");
-}

package/dist/bird/feedback.js

@@ -1,153 +0,0 @@
-import { readFile, writeFile } from "node:fs/promises";
-import { ensureConfigDir, getDataSourcePath, loadConfig } from "./config.js";
-import { addExample } from "./few-shot.js";
-export async function loadFeedback(dataSourceId) {
-    try {
-        const raw = await readFile(getDataSourcePath("feedback", dataSourceId), "utf-8");
-        const parsed = JSON.parse(raw);
-        return parsed.entries ?? [];
-    }
-    catch {
-        return [];
-    }
-}
-async function saveFeedback(dataSourceId, entries) {
-    await ensureConfigDir();
-    const data = { dataSourceId, entries };
-    await writeFile(getDataSourcePath("feedback", dataSourceId), JSON.stringify(data, null, 2), "utf-8");
-}
-export async function recordFeedback(dataSourceId, entry) {
-    const entries = await loadFeedback(dataSourceId);
-    const errorType = entry.rating === "down" && entry.correctSql
-        ? classifyError(entry.generatedSql, entry.correctSql)
-        : undefined;
-    const newEntry = {
-        ...entry,
-        id: `fb_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
-        errorType,
-        promotedToFewShot: false,
-        createdAt: new Date().toISOString(),
-    };
-    entries.push(newEntry);
-    if (newEntry.rating === "down" && newEntry.correctSql && newEntry.errorType) {
-        const config = await loadConfig();
-        if (config.bird.feedback.enabled) {
-            const sameErrorCount = entries.filter((e) => e.errorType === newEntry.errorType && e.rating === "down" && !e.promotedToFewShot).length;
-            if (sameErrorCount >= config.bird.feedback.autoPromoteThreshold) {
-                await promoteToFewShot(dataSourceId, newEntry);
-                newEntry.promotedToFewShot = true;
-            }
-        }
-    }
-    await saveFeedback(dataSourceId, entries);
-    return newEntry;
-}
-export function classifyError(generatedSql, correctSql) {
-    const genTables = extractTables(generatedSql);
-    const correctTables = extractTables(correctSql);
-    const genColumns = extractColumns(generatedSql);
-    const correctColumns = extractColumns(correctSql);
-    const tableDiff = symmetricDifference(genTables, correctTables);
-    if (tableDiff.size > 0) {
-        return "wrong_table";
-    }
-    const colDiff = symmetricDifference(genColumns, correctColumns);
-    if (colDiff.size > 0) {
-        const genJoins = extractJoins(generatedSql);
-        const correctJoins = extractJoins(correctSql);
-        if (genJoins !== correctJoins) {
-            return "wrong_join";
-        }
-        return "wrong_column";
-    }
-    const genWhere = extractWhere(generatedSql);
-    const correctWhere = extractWhere(correctSql);
-    if (genWhere !== correctWhere) {
-        return "wrong_filter";
-    }
-    const genGroup = extractGroupBy(generatedSql);
-    const correctGroup = extractGroupBy(correctSql);
-    if (genGroup !== correctGroup) {
-        return "wrong_aggregation";
-    }
-    return "other";
-}
-async function promoteToFewShot(dataSourceId, entry) {
-    if (!entry.correctSql)
-        return;
-    const tables = [...extractTables(entry.correctSql)];
-    await addExample(dataSourceId, {
-        question: entry.question,
-        sql: entry.correctSql,
-        tables,
-        tags: [entry.errorType ?? "correction"],
-        notes: `Auto-promoted from feedback. Original error: ${entry.errorType}`,
-        source: "feedback",
-    });
-}
-function extractTables(sql) {
-    const tables = new Set();
-    const normalized = sql.toLowerCase().replace(/\s+/g, " ");
-    const fromMatch = normalized.match(/\bfrom\s+(\w+)/g);
-    if (fromMatch) {
-        for (const m of fromMatch) {
-            const t = m.replace(/^from\s+/i, "").trim();
-            if (t && !SQL_KEYWORDS.has(t))
-                tables.add(t);
-        }
-    }
-    const joinMatch = normalized.match(/\bjoin\s+(\w+)/g);
-    if (joinMatch) {
-        for (const m of joinMatch) {
-            const t = m.replace(/^join\s+/i, "").trim();
-            if (t && !SQL_KEYWORDS.has(t))
-                tables.add(t);
-        }
-    }
-    return tables;
-}
-function extractColumns(sql) {
-    const columns = new Set();
-    const normalized = sql.toLowerCase().replace(/\s+/g, " ");
-    const selectMatch = normalized.match(/select\s+(.*?)\s+from/);
-    if (selectMatch) {
-        const cols = selectMatch[1].split(",").map((c) => c.trim().replace(/.*\bas\b\s*/i, ""));
-        for (const c of cols) {
-            if (c !== "*")
-                columns.add(c.replace(/.*\./, ""));
-        }
-    }
-    return columns;
-}
-function extractWhere(sql) {
-    const normalized = sql.toLowerCase().replace(/\s+/g, " ");
-    const match = normalized.match(/\bwhere\s+(.*?)(?:\bgroup\b|\border\b|\blimit\b|\bhaving\b|$)/);
-    return match ? match[1].trim() : "";
-}
-function extractGroupBy(sql) {
-    const normalized = sql.toLowerCase().replace(/\s+/g, " ");
-    const match = normalized.match(/\bgroup\s+by\s+(.*?)(?:\border\b|\blimit\b|\bhaving\b|$)/);
-    return match ? match[1].trim() : "";
-}
-function extractJoins(sql) {
-    const normalized = sql.toLowerCase().replace(/\s+/g, " ");
-    const matches = normalized.match(/\bjoin\s+.*?\bon\s+.*?(?=\bjoin\b|\bwhere\b|\bgroup\b|\border\b|\blimit\b|$)/g);
-    return matches ? matches.sort().join("; ") : "";
-}
-function symmetricDifference(a, b) {
-    const diff = new Set();
-    for (const item of a)
-        if (!b.has(item))
-            diff.add(item);
-    for (const item of b)
-        if (!a.has(item))
-            diff.add(item);
-    return diff;
-}
-const SQL_KEYWORDS = new Set([
-    "select", "from", "where", "join", "inner", "left", "right", "outer",
-    "cross", "on", "and", "or", "not", "in", "exists", "between", "like",
-    "is", "null", "true", "false", "as", "case", "when", "then", "else",
-    "end", "group", "by", "order", "having", "limit", "offset", "union",
-    "all", "distinct", "set", "values", "into", "insert", "update", "delete",
-]);

package/dist/bird/few-shot.js

@@ -1,95 +0,0 @@
-import { readFile, writeFile } from "node:fs/promises";
-import { ensureConfigDir, getDataSourcePath } from "./config.js";
-export async function loadExamples(dataSourceId) {
-    try {
-        const raw = await readFile(getDataSourcePath("few-shot", dataSourceId), "utf-8");
-        const parsed = JSON.parse(raw);
-        return parsed.examples ?? [];
-    }
-    catch {
-        return [];
-    }
-}
-export async function saveExamples(dataSourceId, examples) {
-    await ensureConfigDir();
-    const data = { dataSourceId, examples };
-    await writeFile(getDataSourcePath("few-shot", dataSourceId), JSON.stringify(data, null, 2), "utf-8");
-}
-export async function addExample(dataSourceId, example) {
-    const examples = await loadExamples(dataSourceId);
-    const newExample = {
-        ...example,
-        id: `ex_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
-        createdAt: new Date().toISOString(),
-    };
-    examples.push(newExample);
-    await saveExamples(dataSourceId, examples);
-    return newExample;
-}
-export async function removeExample(dataSourceId, exampleId) {
-    const examples = await loadExamples(dataSourceId);
-    const filtered = examples.filter((e) => e.id !== exampleId);
-    if (filtered.length === examples.length)
-        return false;
-    await saveExamples(dataSourceId, filtered);
-    return true;
-}
-export function findRelevantExamples(question, prunedTableNames, allExamples, maxCount) {
-    if (allExamples.length === 0)
-        return [];
-    const questionTokens = tokenize(question);
-    const scored = allExamples.map((example) => {
-        let score = 0;
-        const tableOverlap = example.tables.filter((t) => prunedTableNames.some((pt) => pt.toLowerCase() === t.toLowerCase())).length;
-        score += tableOverlap * 3;
-        const exampleTokens = tokenize(`${example.question} ${example.tags.join(" ")}`);
-        const keywordOverlap = questionTokens.filter((t) => exampleTokens.includes(t)).length;
-        score += keywordOverlap;
-        return { example, score };
-    });
-    return scored
-        .filter((s) => s.score > 0)
-        .sort((a, b) => b.score - a.score)
-        .slice(0, maxCount)
-        .map((s) => s.example);
-}
-export function formatExamplesForPrompt(examples) {
-    if (examples.length === 0)
-        return "";
-    const lines = ["## Similar query examples:\n"];
-    examples.forEach((ex, i) => {
-        lines.push(`### Example ${i + 1}: "${ex.question}"`);
-        lines.push("```sql");
-        lines.push(ex.sql);
-        lines.push("```");
-        if (ex.notes) {
-            lines.push(`> Note: ${ex.notes}`);
-        }
-        lines.push("");
-    });
-    return lines.join("\n");
-}
-function tokenize(text) {
-    const STOP_WORDS = new Set([
-        "a", "an", "the", "is", "are", "was", "were", "be", "been", "being",
-        "have", "has", "had", "do", "does", "did", "will", "would", "could",
-        "should", "may", "might", "shall", "can", "need", "dare", "ought",
-        "to", "of", "in", "for", "on", "with", "at", "by", "from", "as",
-        "into", "through", "during", "before", "after", "above", "below",
-        "and", "but", "or", "not", "no", "nor", "so", "yet", "both",
-        "each", "all", "any", "few", "more", "most", "other", "some",
-        "such", "than", "too", "very", "just", "about",
-        "me", "my", "i", "you", "your", "we", "our", "they", "their",
-        "it", "its", "this", "that", "these", "those", "what", "which",
-        "who", "whom", "how", "where", "when", "why",
-        "show", "give", "tell", "get", "find", "list", "display",
-        "의", "가", "이", "은", "는", "을", "를", "에", "에서", "와", "과",
-        "도", "로", "으로", "만", "까지", "부터", "에게", "한테", "께",
-        "좀", "해줘", "알려줘", "보여줘", "해", "하는", "된", "인",
-    ]);
-    return text
-        .toLowerCase()
-        .replace(/[^\w\sㄱ-ㅎㅏ-ㅣ가-힣]/g, " ")
-        .split(/\s+/)
-        .filter((w) => w.length > 1 && !STOP_WORDS.has(w));
-}