Changelog

Changelog

All notable changes to the SQLite MCP Server project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

Unreleased

2.6.4 - 2025-12-06

Added

• 🎛️ Tool Filtering System - New SQLITE_MCP_TOOL_FILTER environment variable to selectively enable/disable tools

  • Addresses MCP client tool limits (e.g., Windsurf's 100-tool limit)
  • Filter syntax: -group (disable group), -tool (disable tool), +tool (re-enable tool)
  • Rules processed left-to-right for precise control
  • Works with all MCP clients (Cursor, Claude Desktop, Windsurf, etc.)

• Tool Groups - 10 logical groups for easy bulk filtering:

  Group	Tools	Description
  core	5	Basic CRUD: read_query, write_query, create_table, list_tables, describe_table
  fts	4	Full-text search: fts_search, create_fts_table, rebuild_fts_index, hybrid_search
  vector	11	Semantic/vector search and embeddings
  json	9	JSON operations and validation
  virtual	8	Virtual tables: CSV, R-Tree, series
  spatial	7	SpatiaLite geospatial operations
  text	7	Text processing: fuzzy, phonetic, regex
  stats	8	Statistical analysis
  admin	14	Database administration and PRAGMA
  misc	5	Miscellaneous utilities

• Comprehensive Test Suite - 410 lines of pytest tests for tool filtering (tests/test_tool_filtering.py)

Example Configurations

Reduce to ~50 tools (for Windsurf/limited clients):

SQLITE_MCP_TOOL_FILTER="-vector,-stats,-spatial,-text"

Read-only mode:

SQLITE_MCP_TOOL_FILTER="-write_query,-create_table"

Disable admin but keep vacuum and backup:

SQLITE_MCP_TOOL_FILTER="-admin,+vacuum_database,+backup_database"

Contributors

• @Insighttful - Tool filtering feature (PR #50)

---

2.6.3 - 2025-11-24

Changed

• Updated README documentation
• Consistent version numbering across all files
• Dependency updates (actions/checkout v6, js-yaml 4.1.1)

---

2.6.2 - 2025-10-09

Fixed

• Corrected metadata and repository URLs
• Documentation improvements

---

2.6.1 - 2025-09-22

Added

• JSON Helper Tools - 6 specialized tools for simplified JSON operations
• JSON Auto-Normalization - Automatically fixes Python-style JSON
• Parameter Binding Interface - Enhanced security with SQL injection prevention
• Automatic Parameter Serialization - Direct object/array parameters
• Enhanced JSON Error Diagnostics - Intelligent error categorization

---

2.6.0 - 2025-09-22

Added

• Complete JSON Operations Suite
• Enhanced security features
• Strict type checking with Pyright

Changed

• Major documentation overhaul
• Performance improvements

---

Previous Versions

For changes prior to v2.6.0, see the GitHub Releases page.

---