@neverinfamous/postgres-mcp 1.0.1

package/dist/filtering/ToolConstants.js

@@ -0,0 +1,352 @@
+/**
+ * postgres-mcp - Tool Constants
+ *
+ * Defines the tool groups and meta-groups used for filtering.
+ * STRICT LIMIT: No shortcut may exceed 50 tools.
+ */
+/**
+ * Default tool groups and their member tools.
+ * This serves as the canonical mapping of tools to groups.
+ */
+export const TOOL_GROUPS = {
+    core: [
+        "pg_read_query",
+        "pg_write_query",
+        "pg_list_tables",
+        "pg_describe_table",
+        "pg_create_table",
+        "pg_drop_table",
+        "pg_get_indexes",
+        "pg_create_index",
+        "pg_list_objects",
+        "pg_object_details",
+        "pg_list_extensions",
+        "pg_analyze_db_health",
+        "pg_analyze_workload_indexes",
+        "pg_analyze_query_indexes",
+        // Convenience tools
+        "pg_upsert",
+        "pg_batch_insert",
+        "pg_count",
+        "pg_exists",
+        "pg_truncate",
+        "pg_drop_index",
+    ],
+    transactions: [
+        "pg_transaction_begin",
+        "pg_transaction_commit",
+        "pg_transaction_rollback",
+        "pg_transaction_savepoint",
+        "pg_transaction_release",
+        "pg_transaction_rollback_to",
+        "pg_transaction_execute",
+    ],
+    jsonb: [
+        "pg_jsonb_extract",
+        "pg_jsonb_set",
+        "pg_jsonb_insert",
+        "pg_jsonb_delete",
+        "pg_jsonb_contains",
+        "pg_jsonb_path_query",
+        "pg_jsonb_agg",
+        "pg_jsonb_object",
+        "pg_jsonb_array",
+        "pg_jsonb_keys",
+        "pg_jsonb_strip_nulls",
+        "pg_jsonb_typeof",
+        "pg_jsonb_validate_path",
+        "pg_jsonb_stats",
+        "pg_jsonb_merge",
+        "pg_jsonb_normalize",
+        "pg_jsonb_diff",
+        "pg_jsonb_index_suggest",
+        "pg_jsonb_security_scan",
+    ],
+    text: [
+        "pg_text_search",
+        "pg_text_rank",
+        "pg_trigram_similarity",
+        "pg_fuzzy_match",
+        "pg_regexp_match",
+        "pg_like_search",
+        "pg_text_headline",
+        "pg_create_fts_index",
+        "pg_text_normalize",
+        "pg_text_sentiment",
+        "pg_text_to_vector",
+        "pg_text_to_query",
+        "pg_text_search_config",
+    ],
+    performance: [
+        "pg_explain",
+        "pg_explain_analyze",
+        "pg_explain_buffers",
+        "pg_index_stats",
+        "pg_table_stats",
+        "pg_stat_statements",
+        "pg_stat_activity",
+        "pg_locks",
+        "pg_bloat_check",
+        "pg_cache_hit_ratio",
+        "pg_seq_scan_tables",
+        "pg_index_recommendations",
+        "pg_query_plan_compare",
+        "pg_performance_baseline",
+        "pg_connection_pool_optimize",
+        "pg_partition_strategy_suggest",
+        "pg_unused_indexes",
+        "pg_duplicate_indexes",
+        "pg_vacuum_stats",
+        "pg_query_plan_stats",
+    ],
+    admin: [
+        "pg_vacuum",
+        "pg_vacuum_analyze",
+        "pg_analyze",
+        "pg_reindex",
+        "pg_terminate_backend",
+        "pg_cancel_backend",
+        "pg_reload_conf",
+        "pg_set_config",
+        "pg_reset_stats",
+        "pg_cluster",
+    ],
+    monitoring: [
+        "pg_database_size",
+        "pg_table_sizes",
+        "pg_connection_stats",
+        "pg_replication_status",
+        "pg_server_version",
+        "pg_show_settings",
+        "pg_uptime",
+        "pg_recovery_status",
+        "pg_capacity_planning",
+        "pg_resource_usage_analyze",
+        "pg_alert_threshold_set",
+    ],
+    backup: [
+        "pg_dump_table",
+        "pg_dump_schema",
+        "pg_copy_export",
+        "pg_copy_import",
+        "pg_create_backup_plan",
+        "pg_restore_command",
+        "pg_backup_physical",
+        "pg_restore_validate",
+        "pg_backup_schedule_optimize",
+    ],
+    schema: [
+        "pg_list_schemas",
+        "pg_create_schema",
+        "pg_drop_schema",
+        "pg_list_sequences",
+        "pg_create_sequence",
+        "pg_drop_sequence",
+        "pg_list_views",
+        "pg_create_view",
+        "pg_drop_view",
+        "pg_list_functions",
+        "pg_list_triggers",
+        "pg_list_constraints",
+    ],
+    vector: [
+        "pg_vector_create_extension",
+        "pg_vector_add_column",
+        "pg_vector_insert",
+        "pg_vector_search",
+        "pg_vector_create_index",
+        "pg_vector_distance",
+        "pg_vector_normalize",
+        "pg_vector_aggregate",
+        "pg_vector_cluster",
+        "pg_vector_index_optimize",
+        "pg_hybrid_search",
+        "pg_vector_performance",
+        "pg_vector_dimension_reduce",
+        "pg_vector_embed",
+    ],
+    postgis: [
+        "pg_postgis_create_extension",
+        "pg_geometry_column",
+        "pg_point_in_polygon",
+        "pg_distance",
+        "pg_buffer",
+        "pg_intersection",
+        "pg_bounding_box",
+        "pg_spatial_index",
+        "pg_geocode",
+        "pg_geo_transform",
+        "pg_geo_index_optimize",
+        "pg_geo_cluster",
+        "pg_geometry_buffer",
+        "pg_geometry_intersection",
+        "pg_geometry_transform",
+    ],
+    partitioning: [
+        "pg_list_partitions",
+        "pg_create_partition",
+        "pg_attach_partition",
+        "pg_detach_partition",
+        "pg_partition_info",
+        "pg_create_partitioned_table",
+    ],
+    stats: [
+        "pg_stats_descriptive",
+        "pg_stats_percentiles",
+        "pg_stats_correlation",
+        "pg_stats_regression",
+        "pg_stats_time_series",
+        "pg_stats_distribution",
+        "pg_stats_hypothesis",
+        "pg_stats_sampling",
+    ],
+    cron: [
+        "pg_cron_create_extension",
+        "pg_cron_schedule",
+        "pg_cron_schedule_in_database",
+        "pg_cron_unschedule",
+        "pg_cron_alter_job",
+        "pg_cron_list_jobs",
+        "pg_cron_job_run_details",
+        "pg_cron_cleanup_history",
+    ],
+    partman: [
+        "pg_partman_create_extension",
+        "pg_partman_create_parent",
+        "pg_partman_run_maintenance",
+        "pg_partman_show_partitions",
+        "pg_partman_show_config",
+        "pg_partman_check_default",
+        "pg_partman_partition_data",
+        "pg_partman_set_retention",
+        "pg_partman_undo_partition",
+        "pg_partman_analyze_partition_health",
+    ],
+    kcache: [
+        "pg_kcache_create_extension",
+        "pg_kcache_query_stats",
+        "pg_kcache_top_cpu",
+        "pg_kcache_top_io",
+        "pg_kcache_database_stats",
+        "pg_kcache_resource_analysis",
+        "pg_kcache_reset",
+    ],
+    citext: [
+        "pg_citext_create_extension",
+        "pg_citext_convert_column",
+        "pg_citext_list_columns",
+        "pg_citext_analyze_candidates",
+        "pg_citext_compare",
+        "pg_citext_schema_advisor",
+    ],
+    ltree: [
+        "pg_ltree_create_extension",
+        "pg_ltree_query",
+        "pg_ltree_subpath",
+        "pg_ltree_lca",
+        "pg_ltree_match",
+        "pg_ltree_list_columns",
+        "pg_ltree_convert_column",
+        "pg_ltree_create_index",
+    ],
+    pgcrypto: [
+        "pg_pgcrypto_create_extension",
+        "pg_pgcrypto_hash",
+        "pg_pgcrypto_hmac",
+        "pg_pgcrypto_encrypt",
+        "pg_pgcrypto_decrypt",
+        "pg_pgcrypto_gen_random_uuid",
+        "pg_pgcrypto_gen_random_bytes",
+        "pg_pgcrypto_gen_salt",
+        "pg_pgcrypto_crypt",
+    ],
+    codemode: ["pg_execute_code"],
+};
+/**
+ * Meta-groups that expand to multiple tool groups.
+ * These provide shortcuts for common use cases.
+ *
+ * ALL presets include codemode (pg_execute_code) by default for token efficiency.
+ *
+ * Group sizes:
+ *   core:19, transactions:7, jsonb:19, text:13, performance:20
+ *   admin:10, monitoring:11, backup:9, schema:12, vector:14
+ *   postgis:15, partitioning:6, stats:8, cron:8, partman:10
+ *   kcache:7, citext:6, ltree:8, pgcrypto:9, codemode:1
+ *
+ * Tool counts (with codemode):
+ *   starter:      58 (core:19 + transactions:7 + jsonb:19 + schema:12 + codemode:1)
+ *   essential:    46 (core:19 + transactions:7 + jsonb:19 + codemode:1)
+ *   dev-power:    53 (core:19 + transactions:7 + schema:12 + stats:8 + partitioning:6 + codemode:1)
+ *   ai-data:      59 (core:19 + jsonb:19 + text:13 + transactions:7 + codemode:1)
+ *   ai-vector:    47 (core:19 + vector:14 + transactions:7 + partitioning:6 + codemode:1)
+ *   dba-monitor:  58 (core:19 + monitoring:11 + performance:20 + transactions:7 + codemode:1)
+ *   dba-manage:   57 (core:19 + admin:10 + backup:9 + partitioning:6 + schema:12 + codemode:1)
+ *   dba-stats:    56 (core:19 + admin:10 + monitoring:11 + transactions:7 + stats:8 + codemode:1)
+ *   geo:          42 (core:19 + postgis:15 + transactions:7 + codemode:1)
+ *   base-core:    58 (core:19 + jsonb:19 + transactions:7 + schema:12 + codemode:1)
+ *   base-ops:     51 (admin:10 + monitoring:11 + backup:9 + partitioning:6 + stats:8 + citext:6 + codemode:1)
+ *   ext-ai:       24 (vector:14 + pgcrypto:9 + codemode:1)
+ *   ext-geo:      24 (postgis:15 + ltree:8 + codemode:1)
+ *   ext-schedule: 19 (cron:8 + partman:10 + codemode:1)
+ *   ext-perf:     28 (kcache:7 + performance:20 + codemode:1)
+ */
+export const META_GROUPS = {
+    // 1. General Use (Recommended) - All include codemode for token efficiency
+    starter: ["core", "transactions", "jsonb", "schema", "codemode"], // 50
+    essential: ["core", "transactions", "jsonb", "codemode"], // 40
+    "dev-power": [
+        "core",
+        "transactions",
+        "schema",
+        "stats",
+        "partitioning",
+        "codemode",
+    ], // 45
+    // 2. AI Workloads
+    "ai-data": ["core", "jsonb", "text", "transactions", "codemode"], // 51 (over limit, but codemode is essential)
+    "ai-vector": ["core", "vector", "transactions", "partitioning", "codemode"], // 41
+    // 3. DBA Workloads
+    "dba-monitor": [
+        "core",
+        "monitoring",
+        "performance",
+        "transactions",
+        "codemode",
+    ], // 48
+    "dba-manage": [
+        "core",
+        "admin",
+        "backup",
+        "partitioning",
+        "schema",
+        "codemode",
+    ], // 49
+    "dba-stats": [
+        "core",
+        "admin",
+        "monitoring",
+        "transactions",
+        "stats",
+        "codemode",
+    ], // 50
+    // 4. Specialty Workloads
+    geo: ["core", "postgis", "transactions", "codemode"], // 33
+    // 5. Base Blocks (Building Blocks for Combining)
+    "base-core": ["core", "jsonb", "transactions", "schema", "codemode"], // 50
+    "base-ops": [
+        "admin",
+        "monitoring",
+        "backup",
+        "partitioning",
+        "stats",
+        "citext",
+        "codemode",
+    ], // 51 (adjusted)
+    // 6. Extension Bundles (for adding extension capabilities)
+    "ext-ai": ["vector", "pgcrypto", "codemode"], // 24
+    "ext-geo": ["postgis", "ltree", "codemode"], // 21
+    "ext-schedule": ["cron", "partman", "codemode"], // 19
+    "ext-perf": ["kcache", "performance", "codemode"], // 24
+};
+//# 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":"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"}

package/dist/filtering/ToolFilter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * postgres-mcp - Tool Filtering System
+ *
+ * Parses and applies tool filter rules from environment variables.
+ * Compatible with db-mcp filtering syntax.
+ *
+ * Syntax:
+ *   -group    → Disable all tools in a group
+ *   +group    → Enable all tools in a group
+ *   -tool     → Disable a specific tool
+ *   +tool     → Enable a specific tool (after group disable)
+ */
+import type { ToolGroup, MetaGroup, ToolFilterConfig, ToolDefinition } from "../types/index.js";
+/**
+ * Default tool groups and their member tools.
+ * This serves as the canonical mapping of tools to groups.
+ */
+export { TOOL_GROUPS, META_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 all tool names from a meta-group
+ */
+export declare function getMetaGroupTools(metaGroup: MetaGroup): string[];
+/**
+ * Parse a tool filter string into structured rules
+ *
+ * @param filterString - The filter string (e.g., "starter" or "-vector,-postgis,+pg_vector_search")
+ * @returns Parsed filter configuration
+ */
+export declare function parseToolFilter(filterString: string | undefined): ToolFilterConfig;
+/**
+ * Check if a tool is enabled based on filter configuration
+ */
+export declare function isToolEnabled(toolName: string, 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;
+/**
+ * Calculate token savings from tool filtering
+ * Assumes ~200 tokens per tool definition (description + parameters)
+ */
+export declare function calculateTokenSavings(totalTools: number, enabledTools: number, tokensPerTool?: number): {
+    tokensSaved: number;
+    percentSaved: number;
+};
+/**
+ * Generate a summary of the current filter configuration
+ */
+export declare function getFilterSummary(config: ToolFilterConfig): string;
+/**
+ * Get a list of all tool groups with their tool counts
+ */
+export declare function getToolGroupInfo(): {
+    group: ToolGroup;
+    count: number;
+    tools: string[];
+}[];
+/**
+ * Get a list of all meta-groups with their expanded tool counts
+ */
+export declare function getMetaGroupInfo(): {
+    metaGroup: MetaGroup;
+    groups: ToolGroup[];
+    count: number;
+}[];
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAc3B;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAO1C;AAoBD;;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,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,gBAAgB,CAuIlB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAET;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,CAMvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,SAAM,GAClB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAO/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqCjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,EAAE,CAMF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,EAAE,CAMF"}