db-mcp 1.1.0 → 2.0.0

package/test-server/tool-reference.md

@@ -1,6 +1,6 @@
 # Tool Reference
 
-Complete reference of all **139 Native / 115 WASM tools** organized by 9 tool groups + codemode. Each group automatically includes Code Mode (`sqlite_execute_code`) for token-efficient operations.
+Complete reference of all **151 Native / 125 WASM tools** organized by 10 tool groups + codemode. Each group automatically includes Code Mode (`sqlite_execute_code`) for token-efficient operations.
 
 > **3 built-in tools** (`server_info`, `server_health`, `list_adapters`) are always available regardless of filter settings.
 >
@@ -18,7 +18,7 @@ Sandboxed JavaScript execution that exposes all 9 tool groups through the `sqlit
 
 ---
 
-## core (9 tools + Code Mode)
+## core (14 tools + Code Mode)
 
 Read/write queries, table and index management, and schema discovery.
 
@@ -26,6 +26,11 @@ Read/write queries, table and index management, and schema discovery.
 | ----------------------- | --------------------------------------------------------------------------------------------------------- |
 | `sqlite_read_query`     | Execute a SELECT query on the SQLite database. Returns rows as JSON. Use parameter binding for safety.    |
 | `sqlite_write_query`    | Execute an INSERT, UPDATE, or DELETE query. Returns affected row count. Use parameter binding for safety. |
+| `sqlite_upsert`         | Insert a row or update it if it already exists (INSERT ON CONFLICT DO UPDATE / INSERT OR REPLACE).        |
+| `sqlite_batch_insert`   | Insert multiple rows in a single statement.                                                               |
+| `sqlite_count`          | Count rows in a table, optionally filtered by a WHERE clause.                                             |
+| `sqlite_exists`         | Check whether rows exist in a table, optionally filtered by a WHERE clause.                               |
+| `sqlite_truncate`       | Truncate a table (executes DELETE FROM table).                                                            |
 | `sqlite_list_tables`    | List all tables and views in the database with their column counts.                                       |
 | `sqlite_describe_table` | Get detailed schema information for a table including columns, types, and constraints.                    |
 | `sqlite_create_table`   | Create a new table in the database with specified columns and constraints.                                |
@@ -36,7 +41,7 @@ Read/write queries, table and index management, and schema discovery.
 
 ---
 
-## json (23 tools + Code Mode)
+## json (24 tools + Code Mode)
 
 Comprehensive JSON manipulation — read, write, transform, validate, and analyze JSON documents stored in SQLite.
 
@@ -65,12 +70,13 @@ Comprehensive JSON manipulation — read, write, transform, validate, and analyz
 | `sqlite_jsonb_convert`          | Convert a text JSON column to JSONB binary format for faster processing. Requires SQLite 3.45+.                      |
 | `sqlite_json_storage_info`      | Analyze storage format of a JSON column (text vs JSONB) and report statistics.                                       |
 | `sqlite_json_normalize_column`  | Normalize JSON data in a column (sort keys, compact format) for consistent storage and comparison.                   |
+| `sqlite_json_security_scan`     | Scan JSON columns for sensitive keys (PII/credentials), SQL injection patterns, and XSS attack vectors.              |
 
 ---
 
-## text (17 Native / 13 WASM tools + Code Mode)
+## text (19 Native / 14 WASM tools + Code Mode)
 
-Text processing, regex, fuzzy matching, phonetic search, and FTS5 full-text search.
+Text processing, regex, fuzzy matching, phonetic search, sentiment analysis, and FTS5 full-text search.
 
 | Tool                     | Description                                                                                                                                                                      |
 | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -87,38 +93,43 @@ Text processing, regex, fuzzy matching, phonetic search, and FTS5 full-text sear
 | `sqlite_text_normalize`  | Normalize text using Unicode normalization (NFC, NFD, NFKC, NFKD) or strip accents.                                                                                              |
 | `sqlite_text_validate`   | Validate text values against patterns: email, phone, URL, UUID, IPv4, or custom regex.                                                                                           |
 | `sqlite_advanced_search` | Advanced search combining exact, fuzzy (Levenshtein), and phonetic (Soundex) matching.                                                                                           |
+| `sqlite_text_sentiment`  | Perform basic keyword-based sentiment analysis on raw text. Returns sentiment classification, score, confidence, and optionally matched words. No database query needed.         |
 | `sqlite_fts_create`      | Create an FTS5 full-text search virtual table. `[NATIVE ONLY]`                                                                                                                   |
 | `sqlite_fts_search`      | Search an FTS5 table using full-text query syntax. `[NATIVE ONLY]`                                                                                                               |
 | `sqlite_fts_rebuild`     | Rebuild an FTS5 index to optimize search performance. `[NATIVE ONLY]`                                                                                                            |
 | `sqlite_fts_match_info`  | Get FTS5 match ranking information using bm25. `[NATIVE ONLY]`                                                                                                                   |
+| `sqlite_fts_headline`    | Generate highlighted snippets from FTS5 search results using `highlight()` and `snippet()`. `[NATIVE ONLY]`                                                                      |
 
 ---
 
-## stats (19 Native / 13 WASM tools + Code Mode)
-
-Statistical analysis — descriptive stats, percentiles, correlation, regression, distributions, and window functions.
-
-| Tool                          | Description                                                                                                             |
-| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `sqlite_stats_basic`          | Get basic statistics (count, sum, avg, min, max) for a numeric column.                                                  |
-| `sqlite_stats_count`          | Count rows, optionally distinct values in a column.                                                                     |
-| `sqlite_stats_group_by`       | Aggregate statistics grouped by a column.                                                                               |
-| `sqlite_stats_histogram`      | Create a histogram with specified number of buckets.                                                                    |
-| `sqlite_stats_percentile`     | Calculate percentiles (median, quartiles, etc.) for a column.                                                           |
-| `sqlite_stats_correlation`    | Calculate Pearson correlation coefficient between two numeric columns.                                                  |
-| `sqlite_stats_top_n`          | Get top N values from a column.                                                                                         |
-| `sqlite_stats_distinct`       | Get distinct values from a column.                                                                                      |
-| `sqlite_stats_summary`        | Get summary statistics for multiple columns at once.                                                                    |
-| `sqlite_stats_frequency`      | Get frequency distribution of values in a column.                                                                       |
-| `sqlite_stats_outliers`       | Detect outliers using IQR (Interquartile Range) or Z-score method.                                                      |
-| `sqlite_stats_regression`     | Perform linear or polynomial regression analysis between two columns.                                                   |
-| `sqlite_stats_hypothesis`     | Perform statistical hypothesis tests: one-sample t-test, two-sample t-test, or chi-square test.                         |
-| `sqlite_window_row_number`    | Assign sequential row numbers based on ordering. Useful for pagination and ranking. `[NATIVE ONLY]`                     |
-| `sqlite_window_rank`          | Calculate rank of rows. RANK leaves gaps after ties, DENSE_RANK does not, PERCENT_RANK gives 0–1 range. `[NATIVE ONLY]` |
-| `sqlite_window_lag_lead`      | Access previous (LAG) or next (LEAD) row values. Useful for comparing consecutive rows. `[NATIVE ONLY]`                 |
-| `sqlite_window_running_total` | Calculate running (cumulative) total. Useful for balance tracking, cumulative metrics. `[NATIVE ONLY]`                  |
-| `sqlite_window_moving_avg`    | Calculate moving (rolling) average. Useful for smoothing time series data. `[NATIVE ONLY]`                              |
-| `sqlite_window_ntile`         | Divide rows into N buckets. E.g., 4 buckets = quartiles, 10 = deciles, 100 = percentiles. `[NATIVE ONLY]`               |
+## stats (22 Native / 16 WASM tools + Code Mode)
+
+Statistical analysis — descriptive stats, percentiles, correlation, regression, distributions, anomaly detection, and window functions.
+
+| Tool                               | Description                                                                                                             |
+| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `sqlite_stats_basic`               | Get basic statistics (count, sum, avg, min, max) for a numeric column.                                                  |
+| `sqlite_stats_count`               | Count rows, optionally distinct values in a column.                                                                     |
+| `sqlite_stats_group_by`            | Aggregate statistics grouped by a column.                                                                               |
+| `sqlite_stats_histogram`           | Create a histogram with specified number of buckets.                                                                    |
+| `sqlite_stats_percentile`          | Calculate percentiles (median, quartiles, etc.) for a column.                                                           |
+| `sqlite_stats_correlation`         | Calculate Pearson correlation coefficient between two numeric columns.                                                  |
+| `sqlite_stats_top_n`               | Get top N values from a column.                                                                                         |
+| `sqlite_stats_distinct`            | Get distinct values from a column.                                                                                      |
+| `sqlite_stats_summary`             | Get summary statistics for multiple columns at once.                                                                    |
+| `sqlite_stats_frequency`           | Get frequency distribution of values in a column.                                                                       |
+| `sqlite_stats_outliers`            | Detect outliers using IQR (Interquartile Range) or Z-score method.                                                      |
+| `sqlite_stats_regression`          | Perform linear or polynomial regression analysis between two columns.                                                   |
+| `sqlite_stats_hypothesis`          | Perform statistical hypothesis tests: one-sample t-test, two-sample t-test, or chi-square test.                         |
+| `sqlite_stats_detect_anomalies`    | Detect data distribution anomalies using z-score analysis across numeric columns. Returns per-column risk assessment.   |
+| `sqlite_stats_detect_bloat`        | Score tables by fragmentation/bloat risk using PRAGMA + dbstat metrics. Returns weighted risk scores (0-100).           |
+| `sqlite_stats_detect_schema_risks` | Score tables by schema health risk: missing FK indexes, no PKs, wide tables, large unindexed tables. Risk scores 0-100. |
+| `sqlite_window_row_number`         | Assign sequential row numbers based on ordering. Useful for pagination and ranking. `[NATIVE ONLY]`                     |
+| `sqlite_window_rank`               | Calculate rank of rows. RANK leaves gaps after ties, DENSE_RANK does not, PERCENT_RANK gives 0–1 range. `[NATIVE ONLY]` |
+| `sqlite_window_lag_lead`           | Access previous (LAG) or next (LEAD) row values. Useful for comparing consecutive rows. `[NATIVE ONLY]`                 |
+| `sqlite_window_running_total`      | Calculate running (cumulative) total. Useful for balance tracking, cumulative metrics. `[NATIVE ONLY]`                  |
+| `sqlite_window_moving_avg`         | Calculate moving (rolling) average. Useful for smoothing time series data. `[NATIVE ONLY]`                              |
+| `sqlite_window_ntile`              | Divide rows into N buckets. E.g., 4 buckets = quartiles, 10 = deciles, 100 = percentiles. `[NATIVE ONLY]`               |
 
 ---
 
@@ -142,39 +153,49 @@ Vector storage, similarity search, and distance calculations for embeddings and
 
 ---
 
-## admin (33 Native / 26 WASM tools + Code Mode)
+## admin (26 Native / 26 WASM tools + Code Mode)
+
+Database maintenance — backup/restore, PRAGMA, views, and virtual tables.
+
+| Tool                            | Description                                                                                                               |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `sqlite_backup`                 | Create a backup of the database to a file.                                                                                |
+| `sqlite_analyze`                | Analyze table statistics to improve query performance.                                                                    |
+| `sqlite_integrity_check`        | Check database integrity for corruption or errors.                                                                        |
+| `sqlite_optimize`               | Optimize database by reindexing and/or analyzing.                                                                         |
+| `sqlite_restore`                | Restore database from a backup file. WARNING: This replaces the current database.                                         |
+| `sqlite_verify_backup`          | Verify a backup file's integrity without restoring it.                                                                    |
+| `sqlite_index_stats`            | Get detailed statistics for database indexes.                                                                             |
+| `sqlite_pragma_compile_options` | Get the compile-time options used to build SQLite. Use the `filter` parameter to reduce output (~50+ options by default). |
+| `sqlite_pragma_database_list`   | List all attached databases.                                                                                              |
+| `sqlite_pragma_optimize`        | Run `PRAGMA optimize` to improve query performance based on usage patterns.                                               |
+| `sqlite_pragma_settings`        | Get or set a PRAGMA value.                                                                                                |
+| `sqlite_pragma_table_info`      | Get detailed column information for a table.                                                                              |
+| `sqlite_append_insight`         | Add a business insight to the `memo://insights` resource. Use this to capture key findings during data analysis.          |
+| `sqlite_generate_series`        | Generate a series of numbers using `generate_series()` virtual table.                                                     |
+| `sqlite_create_view`            | Create a view based on a SELECT query.                                                                                    |
+| `sqlite_list_views`             | List all views in the database.                                                                                           |
+| `sqlite_drop_view`              | Drop (delete) a view from the database.                                                                                   |
+| `sqlite_dbstat`                 | Get database storage statistics using dbstat virtual table.                                                               |
+| `sqlite_vacuum`                 | Rebuild the database to reclaim space and optimize structure.                                                             |
+| `sqlite_list_virtual_tables`    | List all virtual tables in the database.                                                                                  |
+| `sqlite_virtual_table_info`     | Get metadata about a specific virtual table.                                                                              |
+| `sqlite_drop_virtual_table`     | Drop a virtual table.                                                                                                     |
+| `sqlite_create_csv_table`       | Create a virtual table from a CSV file. Requires the csv extension.                                                       |
+| `sqlite_analyze_csv_schema`     | Analyze a CSV file structure and infer column types. Uses a temporary virtual table.                                      |
+| `sqlite_create_rtree_table`     | Create an R-Tree virtual table for spatial indexing. Supports 2–5 dimensions.                                             |
+| `sqlite_create_series_table`    | Create a table populated with a series of numbers. Unlike `generate_series`, this creates a persistent table.             |
 
-Database maintenance — backup/restore, PRAGMA, views, virtual tables, and transaction control.
+---
+
+## transactions (8 Native tools + Code Mode)
+
+Transaction control — begin, commit, rollback, savepoints, and atomic multi-statement execution.
 
 | Tool                             | Description                                                                                                                       |
 | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
-| `sqlite_backup`                  | Create a backup of the database to a file.                                                                                        |
-| `sqlite_analyze`                 | Analyze table statistics to improve query performance.                                                                            |
-| `sqlite_integrity_check`         | Check database integrity for corruption or errors.                                                                                |
-| `sqlite_optimize`                | Optimize database by reindexing and/or analyzing.                                                                                 |
-| `sqlite_restore`                 | Restore database from a backup file. WARNING: This replaces the current database.                                                 |
-| `sqlite_verify_backup`           | Verify a backup file's integrity without restoring it.                                                                            |
-| `sqlite_index_stats`             | Get detailed statistics for database indexes.                                                                                     |
-| `sqlite_pragma_compile_options`  | Get the compile-time options used to build SQLite. Use the `filter` parameter to reduce output (~50+ options by default).         |
-| `sqlite_pragma_database_list`    | List all attached databases.                                                                                                      |
-| `sqlite_pragma_optimize`         | Run `PRAGMA optimize` to improve query performance based on usage patterns.                                                       |
-| `sqlite_pragma_settings`         | Get or set a PRAGMA value.                                                                                                        |
-| `sqlite_pragma_table_info`       | Get detailed column information for a table.                                                                                      |
-| `sqlite_append_insight`          | Add a business insight to the `memo://insights` resource. Use this to capture key findings during data analysis.                  |
-| `sqlite_generate_series`         | Generate a series of numbers using `generate_series()` virtual table.                                                             |
-| `sqlite_create_view`             | Create a view based on a SELECT query.                                                                                            |
-| `sqlite_list_views`              | List all views in the database.                                                                                                   |
-| `sqlite_drop_view`               | Drop (delete) a view from the database.                                                                                           |
-| `sqlite_dbstat`                  | Get database storage statistics using dbstat virtual table.                                                                       |
-| `sqlite_vacuum`                  | Rebuild the database to reclaim space and optimize structure.                                                                     |
-| `sqlite_list_virtual_tables`     | List all virtual tables in the database.                                                                                          |
-| `sqlite_virtual_table_info`      | Get metadata about a specific virtual table.                                                                                      |
-| `sqlite_drop_virtual_table`      | Drop a virtual table.                                                                                                             |
-| `sqlite_create_csv_table`        | Create a virtual table from a CSV file. Requires the csv extension.                                                               |
-| `sqlite_analyze_csv_schema`      | Analyze a CSV file structure and infer column types. Uses a temporary virtual table.                                              |
-| `sqlite_create_rtree_table`      | Create an R-Tree virtual table for spatial indexing. Supports 2–5 dimensions.                                                     |
-| `sqlite_create_series_table`     | Create a table populated with a series of numbers. Unlike `generate_series`, this creates a persistent table.                     |
 | `sqlite_transaction_begin`       | Begin a new transaction. Use immediate or exclusive mode for write-heavy operations. `[NATIVE ONLY]`                              |
+| `sqlite_transaction_status`      | Check whether a transaction is currently active. Returns status and a boolean flag. Read-only. `[NATIVE ONLY]`                    |
 | `sqlite_transaction_commit`      | Commit the current transaction, making all changes permanent. `[NATIVE ONLY]`                                                     |
 | `sqlite_transaction_rollback`    | Rollback the current transaction, discarding all changes. `[NATIVE ONLY]`                                                         |
 | `sqlite_transaction_savepoint`   | Create a savepoint within the current transaction for partial rollback. `[NATIVE ONLY]`                                           |

package/tsconfig.build.json

@@ -0,0 +1,6 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "ignoreDeprecations": "6.0"
+  }
+}