db-mcp 1.0.1

package/dist/filtering/ToolConstants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * db-mcp - Tool Constants
+ *
+ * Defines the tool groups and meta-groups used for filtering.
+ *
+ * Actual tool groups (from code audit):
+ *   core: 8 tools (from core.ts)
+ *   json: 23 tools (from json-helpers.ts + json-operations.ts)
+ *   text: 17 tools (from text.ts + fts.ts)
+ *   stats: 19 tools (from stats.ts + window.ts)
+ *   vector: 11 tools (from vector.ts)
+ *   admin: 33 tools (from admin.ts + virtual.ts + transactions.ts)
+ *   geo: 11 tools (from geo.ts + spatialite.ts) - Native: 11, WASM: 4
+ *   Total: 122 Native / 102 WASM tools
+ *
+ * Note: 3 built-in server tools (server_info, server_health, list_adapters)
+ * are always available regardless of filter settings.
+ */
+import type { ToolGroup, MetaGroup } from "../types/index.js";
+/**
+ * All valid tool groups
+ */
+export declare const ALL_TOOL_GROUPS: ToolGroup[];
+/**
+ * Tool groups - kept for backwards compatibility with scopes.ts
+ * The actual filtering uses the tool's 'group' property, not these lists.
+ */
+export declare const TOOL_GROUPS: Record<ToolGroup, string[]>;
+/**
+ * Meta-groups that expand to multiple tool groups.
+ * These provide shortcuts for common use cases.
+ */
+export declare const META_GROUPS: Record<MetaGroup, ToolGroup[]>;
+//# sourceMappingURL=ToolConstants.d.ts.map

package/dist/filtering/ToolConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolConstants.d.ts","sourceRoot":"","sources":["../../src/filtering/ToolConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,EAQtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAwHnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,CAkBtD,CAAC"}

package/dist/filtering/ToolConstants.js

@@ -0,0 +1,174 @@
+/**
+ * db-mcp - Tool Constants
+ *
+ * Defines the tool groups and meta-groups used for filtering.
+ *
+ * Actual tool groups (from code audit):
+ *   core: 8 tools (from core.ts)
+ *   json: 23 tools (from json-helpers.ts + json-operations.ts)
+ *   text: 17 tools (from text.ts + fts.ts)
+ *   stats: 19 tools (from stats.ts + window.ts)
+ *   vector: 11 tools (from vector.ts)
+ *   admin: 33 tools (from admin.ts + virtual.ts + transactions.ts)
+ *   geo: 11 tools (from geo.ts + spatialite.ts) - Native: 11, WASM: 4
+ *   Total: 122 Native / 102 WASM tools
+ *
+ * Note: 3 built-in server tools (server_info, server_health, list_adapters)
+ * are always available regardless of filter settings.
+ */
+/**
+ * All valid tool groups
+ */
+export const ALL_TOOL_GROUPS = [
+    "core",
+    "json",
+    "text",
+    "stats",
+    "vector",
+    "admin",
+    "geo",
+];
+/**
+ * Tool groups - kept for backwards compatibility with scopes.ts
+ * The actual filtering uses the tool's 'group' property, not these lists.
+ */
+export const TOOL_GROUPS = {
+    core: [
+        "read_query",
+        "write_query",
+        "list_tables",
+        "describe_table",
+        "create_table",
+        "drop_table",
+        "get_indexes",
+        "create_index",
+    ],
+    json: [
+        // JSON Helper Tools (8)
+        "json_insert",
+        "json_update",
+        "json_select",
+        "json_query",
+        "json_validate_path",
+        "json_merge",
+        "json_analyze_schema",
+        "create_json_collection",
+        // JSON Operation Tools (12)
+        "json_valid",
+        "json_extract",
+        "json_set",
+        "json_remove",
+        "json_type",
+        "json_array_length",
+        "json_array_append",
+        "json_keys",
+        "json_each",
+        "json_group_array",
+        "json_group_object",
+        "json_pretty",
+        // JSONB Tools (3)
+        "jsonb_convert",
+        "json_storage_info",
+        "json_normalize_column",
+    ],
+    text: [
+        "regex_extract",
+        "regex_match",
+        "text_split",
+        "text_concat",
+        "text_replace",
+        "text_trim",
+        "text_case",
+        "text_substring",
+        "fts_create",
+        "fts_insert",
+        "fts_search",
+        "fts_match",
+    ],
+    stats: [
+        "stats_basic",
+        "stats_count",
+        "stats_group_by",
+        "stats_histogram",
+        "stats_percentile",
+        "stats_regression",
+        "stats_correlation",
+        "stats_zscore",
+        "stats_time_bucket",
+        "stats_moving_avg",
+        "geo_distance",
+        "geo_bounding_box",
+        "geo_point_in_radius",
+        "geo_nearest",
+        "geo_encode",
+        "geo_decode",
+    ],
+    vector: [
+        "vector_create_table",
+        "vector_store",
+        "vector_batch_store",
+        "vector_search",
+        "vector_get",
+        "vector_delete",
+        "vector_count",
+        "vector_stats",
+        "vector_dimensions",
+        "vector_normalize",
+        "vector_distance",
+    ],
+    admin: [
+        "backup",
+        "analyze",
+        "integrity_check",
+        "optimize",
+        "generate_series",
+        "create_view",
+        "list_views",
+        "drop_view",
+        "dbstat",
+        "vacuum",
+        "transaction_begin",
+        "transaction_commit",
+        "transaction_rollback",
+        "transaction_savepoint",
+        "transaction_release",
+        "transaction_rollback_to",
+        "transaction_execute",
+        "window_row_number",
+        "window_rank",
+        "window_lag_lead",
+        "window_running_total",
+    ],
+    geo: [
+        "geo_distance",
+        "geo_nearby",
+        "geo_bounding_box",
+        "geo_cluster",
+        "spatialite_load",
+        "spatialite_create_table",
+        "spatialite_query",
+        "spatialite_analyze",
+        "spatialite_index",
+        "spatialite_transform",
+        "spatialite_import",
+    ],
+};
+/**
+ * Meta-groups that expand to multiple tool groups.
+ * These provide shortcuts for common use cases.
+ */
+export const META_GROUPS = {
+    // General development - Core + JSON + Text (48 tools)
+    starter: ["core", "json", "text"],
+    // Data analysis - Core + JSON + Stats (50 tools Native, 44 WASM)
+    analytics: ["core", "json", "stats"],
+    // Search workloads - Core + Text + Vector (36 tools)
+    search: ["core", "text", "vector"],
+    // Geospatial workloads - Core + Geo + Vector (30 tools Native, 23 WASM)
+    spatial: ["core", "geo", "vector"],
+    // Bare minimum - Core only (8 tools)
+    minimal: ["core"],
+    // All tools enabled (122 Native / 102 WASM tools)
+    full: ["core", "json", "text", "stats", "vector", "admin", "geo"],
+};
+//# sourceMappingURL=ToolConstants.js.map

package/dist/filtering/ToolConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolConstants.js","sourceRoot":"","sources":["../../src/filtering/ToolConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgC;IACtD,IAAI,EAAE;QACJ,YAAY;QACZ,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,cAAc;QACd,YAAY;QACZ,aAAa;QACb,cAAc;KACf;IACD,IAAI,EAAE;QACJ,wBAAwB;QACxB,aAAa;QACb,aAAa;QACb,aAAa;QACb,YAAY;QACZ,oBAAoB;QACpB,YAAY;QACZ,qBAAqB;QACrB,wBAAwB;QACxB,4BAA4B;QAC5B,YAAY;QACZ,cAAc;QACd,UAAU;QACV,aAAa;QACb,WAAW;QACX,mBAAmB;QACnB,mBAAmB;QACnB,WAAW;QACX,WAAW;QACX,kBAAkB;QAClB,mBAAmB;QACnB,aAAa;QACb,kBAAkB;QAClB,eAAe;QACf,mBAAmB;QACnB,uBAAuB;KACxB;IACD,IAAI,EAAE;QACJ,eAAe;QACf,aAAa;QACb,YAAY;QACZ,aAAa;QACb,cAAc;QACd,WAAW;QACX,WAAW;QACX,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,WAAW;KACZ;IACD,KAAK,EAAE;QACL,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,kBAAkB;QAClB,mBAAmB;QACnB,cAAc;QACd,mBAAmB;QACnB,kBAAkB;QAClB,cAAc;QACd,kBAAkB;QAClB,qBAAqB;QACrB,aAAa;QACb,YAAY;QACZ,YAAY;KACb;IACD,MAAM,EAAE;QACN,qBAAqB;QACrB,cAAc;QACd,oBAAoB;QACpB,eAAe;QACf,YAAY;QACZ,eAAe;QACf,cAAc;QACd,cAAc;QACd,mBAAmB;QACnB,kBAAkB;QAClB,iBAAiB;KAClB;IACD,KAAK,EAAE;QACL,QAAQ;QACR,SAAS;QACT,iBAAiB;QACjB,UAAU;QACV,iBAAiB;QACjB,aAAa;QACb,YAAY;QACZ,WAAW;QACX,QAAQ;QACR,QAAQ;QACR,mBAAmB;QACnB,oBAAoB;QACpB,sBAAsB;QACtB,uBAAuB;QACvB,qBAAqB;QACrB,yBAAyB;QACzB,qBAAqB;QACrB,mBAAmB;QACnB,aAAa;QACb,iBAAiB;QACjB,sBAAsB;KACvB;IACD,GAAG,EAAE;QACH,cAAc;QACd,YAAY;QACZ,kBAAkB;QAClB,aAAa;QACb,iBAAiB;QACjB,yBAAyB;QACzB,kBAAkB;QAClB,oBAAoB;QACpB,kBAAkB;QAClB,sBAAsB;QACtB,mBAAmB;KACpB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAmC;IACzD,sDAAsD;IACtD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAEjC,iEAAiE;IACjE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IAEpC,qDAAqD;IACrD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;IAElC,wEAAwE;IACxE,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;IAElC,qCAAqC;IACrC,OAAO,EAAE,CAAC,MAAM,CAAC;IAEjB,kDAAkD;IAClD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;CAClE,CAAC"}

package/dist/filtering/ToolFilter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * db-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with postgres-mcp-server filtering syntax.
+ *
+ * Syntax:
+ *   groupName     → Enable only this group (whitelist mode)
+ *   shortcut      → Use a preset (starter, analytics, search, etc.)
+ *   -group        → Disable all tools in a group
+ *   +group        → Enable all tools in a group
+ *   -tool         → Disable a specific tool
+ *   +tool         → Enable a specific tool
+ *
+ * Mode Detection:
+ *   - If first token starts with '-', start with ALL groups enabled (exclusion mode)
+ *   - Otherwise, start with NO groups enabled (whitelist mode)
+ *
+ * Examples:
+ *   "core,json"           → Whitelist: only core and json groups
+ *   "starter"             → Preset: core + json + text groups
+ *   "starter,-fts5"       → Preset minus fts5 group
+ *   "-vector,-geo"        → Legacy: all groups except vector and geo
+ */
+import type { ToolGroup, MetaGroup, ToolFilterConfig, ToolDefinition } from "../types/index.js";
+export { META_GROUPS, TOOL_GROUPS, ALL_TOOL_GROUPS } from "./ToolConstants.js";
+/**
+ * Get all tool names from all groups (cached)
+ */
+export declare function getAllToolNames(): string[];
+/**
+ * Get the group for a specific tool (O(1) lookup)
+ */
+export declare function getToolGroup(toolName: string): ToolGroup | undefined;
+/**
+ * Clear all caches - useful for testing
+ */
+export declare function clearToolFilterCaches(): void;
+/**
+ * Check if a name is a valid tool group
+ */
+export declare function isToolGroup(name: string): name is ToolGroup;
+/**
+ * Check if a name is a valid meta-group
+ */
+export declare function isMetaGroup(name: string): name is MetaGroup;
+/**
+ * Get tool groups from a meta-group
+ */
+export declare function getMetaGroupGroups(metaGroup: MetaGroup): ToolGroup[];
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "starter" or "-vector,-geo")
+ * @returns Parsed filter configuration with enabled groups
+ */
+export declare function parseToolFilter(filterString: string | undefined): ToolFilterConfig;
+/**
+ * Check if a tool is enabled based on filter configuration
+ * Uses the tool's group property for matching
+ */
+export declare function isToolEnabled(tool: ToolDefinition, config: ToolFilterConfig): boolean;
+/**
+ * Filter a list of tool definitions based on filter configuration
+ */
+export declare function filterTools(tools: ToolDefinition[], config: ToolFilterConfig): ToolDefinition[];
+/**
+ * Get the tool filter from environment variable
+ */
+export declare function getToolFilterFromEnv(): ToolFilterConfig;
+/**
+ * Generate a summary of the current filter configuration
+ */
+export declare function getFilterSummary(config: ToolFilterConfig): string;
+/**
+ * Get a list of all meta-groups with their expanded groups
+ */
+export declare function getMetaGroupInfo(): {
+    metaGroup: MetaGroup;
+    groups: ToolGroup[];
+}[];
+//# sourceMappingURL=ToolFilter.d.ts.map

package/dist/filtering/ToolFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolFilter.d.ts","sourceRoot":"","sources":["../../src/filtering/ToolFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAc/E;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,gBAAgB,CA+HlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAwBT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,gBAAgB,GACvB,cAAc,EAAE,CAElB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAIvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAiCjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB,EAAE,CAKF"}

package/dist/filtering/ToolFilter.js

@@ -0,0 +1,296 @@
+/**
+ * db-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with postgres-mcp-server filtering syntax.
+ *
+ * Syntax:
+ *   groupName     → Enable only this group (whitelist mode)
+ *   shortcut      → Use a preset (starter, analytics, search, etc.)
+ *   -group        → Disable all tools in a group
+ *   +group        → Enable all tools in a group
+ *   -tool         → Disable a specific tool
+ *   +tool         → Enable a specific tool
+ *
+ * Mode Detection:
+ *   - If first token starts with '-', start with ALL groups enabled (exclusion mode)
+ *   - Otherwise, start with NO groups enabled (whitelist mode)
+ *
+ * Examples:
+ *   "core,json"           → Whitelist: only core and json groups
+ *   "starter"             → Preset: core + json + text groups
+ *   "starter,-fts5"       → Preset minus fts5 group
+ *   "-vector,-geo"        → Legacy: all groups except vector and geo
+ */
+import { META_GROUPS, ALL_TOOL_GROUPS, TOOL_GROUPS } from "./ToolConstants.js";
+// Re-export for backwards compatibility
+export { META_GROUPS, TOOL_GROUPS, ALL_TOOL_GROUPS } from "./ToolConstants.js";
+/**
+ * Cached list of all tool names
+ * Lazy-initialized since TOOL_GROUPS is immutable
+ */
+let cachedAllToolNames = null;
+/**
+ * Reverse lookup map: tool name -> group
+ * Lazy-initialized for O(1) tool group lookups
+ */
+let toolToGroupMap = null;
+/**
+ * Get all tool names from all groups (cached)
+ */
+export function getAllToolNames() {
+    if (cachedAllToolNames) {
+        return cachedAllToolNames;
+    }
+    cachedAllToolNames = ALL_TOOL_GROUPS.flatMap((group) => TOOL_GROUPS[group]);
+    return cachedAllToolNames;
+}
+/**
+ * Get or initialize the tool-to-group reverse lookup map
+ */
+function getToolToGroupMap() {
+    if (toolToGroupMap) {
+        return toolToGroupMap;
+    }
+    toolToGroupMap = new Map();
+    for (const group of ALL_TOOL_GROUPS) {
+        for (const tool of TOOL_GROUPS[group]) {
+            toolToGroupMap.set(tool, group);
+        }
+    }
+    return toolToGroupMap;
+}
+/**
+ * Get the group for a specific tool (O(1) lookup)
+ */
+export function getToolGroup(toolName) {
+    return getToolToGroupMap().get(toolName);
+}
+/**
+ * Clear all caches - useful for testing
+ */
+export function clearToolFilterCaches() {
+    cachedAllToolNames = null;
+    toolToGroupMap = null;
+}
+/**
+ * Check if a name is a valid tool group
+ */
+export function isToolGroup(name) {
+    return ALL_TOOL_GROUPS.includes(name);
+}
+/**
+ * Check if a name is a valid meta-group
+ */
+export function isMetaGroup(name) {
+    return name in META_GROUPS;
+}
+/**
+ * Get tool groups from a meta-group
+ */
+export function getMetaGroupGroups(metaGroup) {
+    return META_GROUPS[metaGroup];
+}
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "starter" or "-vector,-geo")
+ * @returns Parsed filter configuration with enabled groups
+ */
+export function parseToolFilter(filterString) {
+    // Default: all groups enabled, no specific tool exclusions
+    const enabledGroups = new Set(ALL_TOOL_GROUPS);
+    const excludedTools = new Set();
+    const includedTools = new Set();
+    if (!filterString || filterString.trim() === "") {
+        return {
+            raw: "",
+            rules: [],
+            enabledGroups,
+            excludedTools,
+            includedTools,
+        };
+    }
+    const rules = [];
+    const parts = filterString
+        .split(",")
+        .map((p) => p.trim())
+        .filter((p) => p);
+    if (parts.length === 0) {
+        return {
+            raw: filterString,
+            rules: [],
+            enabledGroups,
+            excludedTools,
+            includedTools,
+        };
+    }
+    // Mode detection: if first token starts with '-', exclusion mode (legacy)
+    // Otherwise, whitelist mode (new) - start with empty groups
+    const firstPart = parts[0];
+    if (!firstPart) {
+        return {
+            raw: filterString,
+            rules: [],
+            enabledGroups,
+            excludedTools,
+            includedTools,
+        };
+    }
+    const startsWithExclude = firstPart.startsWith("-");
+    if (!startsWithExclude) {
+        enabledGroups.clear();
+    }
+    for (const part of parts) {
+        if (!part)
+            continue;
+        let isInclude = true; // Default to include (whitelist mode)
+        let isExclude = false;
+        let target = part;
+        if (part.startsWith("+")) {
+            isInclude = true;
+            target = part.substring(1);
+        }
+        else if (part.startsWith("-")) {
+            isInclude = false;
+            isExclude = true;
+            target = part.substring(1);
+        }
+        // No prefix = include (whitelist mode)
+        // Special case: 'all'
+        if (target === "all") {
+            if (isExclude) {
+                enabledGroups.clear();
+            }
+            else {
+                for (const group of ALL_TOOL_GROUPS) {
+                    enabledGroups.add(group);
+                }
+            }
+            continue;
+        }
+        const targetIsMetaGroup = isMetaGroup(target);
+        const targetIsGroup = isToolGroup(target);
+        rules.push({
+            type: isInclude ? "include" : "exclude",
+            target,
+            isGroup: targetIsGroup || targetIsMetaGroup,
+        });
+        // Apply rule - check meta-groups first, then regular groups, then individual tools
+        if (targetIsMetaGroup) {
+            // Expand meta-group to its constituent groups
+            const groupsInMeta = getMetaGroupGroups(target);
+            if (isExclude) {
+                for (const group of groupsInMeta) {
+                    enabledGroups.delete(group);
+                }
+            }
+            else {
+                for (const group of groupsInMeta) {
+                    enabledGroups.add(group);
+                }
+            }
+        }
+        else if (targetIsGroup) {
+            // Add/remove a single group
+            if (isExclude) {
+                enabledGroups.delete(target);
+            }
+            else {
+                enabledGroups.add(target);
+            }
+        }
+        else {
+            // Individual tool - track in include/exclude sets
+            if (isExclude) {
+                excludedTools.add(target);
+                includedTools.delete(target);
+            }
+            else {
+                includedTools.add(target);
+                excludedTools.delete(target);
+            }
+        }
+    }
+    return {
+        raw: filterString,
+        rules,
+        enabledGroups,
+        excludedTools,
+        includedTools,
+    };
+}
+/**
+ * Check if a tool is enabled based on filter configuration
+ * Uses the tool's group property for matching
+ */
+export function isToolEnabled(tool, config) {
+    const baseName = tool.name.replace(/^(sqlite|mysql|postgres|mongodb|redis|sqlserver)_/, "");
+    // Check explicit tool exclusion
+    if (config.excludedTools.has(tool.name) ||
+        config.excludedTools.has(baseName)) {
+        return false;
+    }
+    // Check explicit tool inclusion
+    if (config.includedTools.has(tool.name) ||
+        config.includedTools.has(baseName)) {
+        return true;
+    }
+    // Check if tool's group is enabled
+    return config.enabledGroups.has(tool.group);
+}
+/**
+ * Filter a list of tool definitions based on filter configuration
+ */
+export function filterTools(tools, config) {
+    return tools.filter((tool) => isToolEnabled(tool, config));
+}
+/**
+ * Get the tool filter from environment variable
+ */
+export function getToolFilterFromEnv() {
+    const filterString = process.env["DB_MCP_TOOL_FILTER"] ?? process.env["TOOL_FILTER"] ?? "";
+    return parseToolFilter(filterString);
+}
+/**
+ * Generate a summary of the current filter configuration
+ */
+export function getFilterSummary(config) {
+    const lines = [
+        `Tool Filter Summary:`,
+        `  Filter: ${config.raw || "(none)"}`,
+        `  Enabled groups: ${config.enabledGroups.size}/${ALL_TOOL_GROUPS.length}`,
+    ];
+    if (config.enabledGroups.size > 0) {
+        lines.push(`    Groups: ${[...config.enabledGroups].join(", ")}`);
+    }
+    if (config.excludedTools.size > 0) {
+        lines.push(`  Excluded tools: ${[...config.excludedTools].join(", ")}`);
+    }
+    if (config.includedTools.size > 0) {
+        lines.push(`  Included tools: ${[...config.includedTools].join(", ")}`);
+    }
+    if (config.rules.length > 0) {
+        lines.push(`  Rules applied: ${config.rules.length}`);
+        for (const rule of config.rules) {
+            const prefix = rule.type === "include" ? "+" : "-";
+            const type = isMetaGroup(rule.target)
+                ? "meta-group"
+                : rule.isGroup
+                    ? "group"
+                    : "tool";
+            lines.push(`    ${prefix}${rule.target} (${type})`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Get a list of all meta-groups with their expanded groups
+ */
+export function getMetaGroupInfo() {
+    return Object.entries(META_GROUPS).map(([metaGroup, groups]) => ({
+        metaGroup: metaGroup,
+        groups,
+    }));
+}
+//# sourceMappingURL=ToolFilter.js.map

package/dist/filtering/ToolFilter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * db-mcp - SQLite MCP Server
+ *
+ * Main entry point and public API exports.
+ */
+export { DbMcpServer, createServer, DEFAULT_CONFIG, } from "./server/McpServer.js";
+export type { DatabaseType, DatabaseConfig, HealthStatus, QueryResult, ColumnInfo, TableInfo, SchemaInfo, IndexInfo, ConstraintInfo, TransportType, McpServerConfig, OAuthConfig, OAuthScope, TokenClaims, RequestContext, ToolGroup, ToolFilterRule, ToolFilterConfig, AdapterCapabilities, ToolDefinition, ResourceDefinition, PromptDefinition, } from "./types/index.js";
+export { DbMcpError, ConnectionError, QueryError, AuthenticationError, AuthorizationError, ValidationError, } from "./types/index.js";
+export { DatabaseAdapter } from "./adapters/DatabaseAdapter.js";
+export { TOOL_GROUPS, META_GROUPS, ALL_TOOL_GROUPS, parseToolFilter, isToolEnabled, filterTools, getToolFilterFromEnv, getFilterSummary, } from "./filtering/ToolFilter.js";
+export declare const VERSION = "0.1.0";
+export declare const NAME = "db-mcp";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAEV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EAGd,aAAa,EACb,eAAe,EAGf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EAGd,SAAS,EACT,cAAc,EACd,gBAAgB,EAGhB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,IAAI,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * db-mcp - SQLite MCP Server
+ *
+ * Main entry point and public API exports.
+ */
+// Core server
+export { DbMcpServer, createServer, DEFAULT_CONFIG, } from "./server/McpServer.js";
+// Error classes
+export { DbMcpError, ConnectionError, QueryError, AuthenticationError, AuthorizationError, ValidationError, } from "./types/index.js";
+// Base adapter class
+export { DatabaseAdapter } from "./adapters/DatabaseAdapter.js";
+// Tool filtering utilities
+export { TOOL_GROUPS, META_GROUPS, ALL_TOOL_GROUPS, parseToolFilter, isToolEnabled, filterTools, getToolFilterFromEnv, getFilterSummary, } from "./filtering/ToolFilter.js";
+// Version info
+export const VERSION = "0.1.0";
+export const NAME = "db-mcp";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc;AACd,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAqC/B,gBAAgB;AAChB,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,2BAA2B;AAC3B,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,eAAe;AACf,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC"}