mcp-sqlite-memory-bank 1.5.1__tar.gz → 1.6.0__tar.gz

{mcp_sqlite_memory_bank-1.5.1/src/mcp_sqlite_memory_bank.egg-info → mcp_sqlite_memory_bank-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp_sqlite_memory_bank
-Version: 1.5.1
+Version: 1.6.0
 Summary: A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers with semantic search capabilities.
 Author-email: Robert Meisner <robert@catchit.pl>
 License-Expression: MIT
@@ -9,13 +9,13 @@ Project-URL: Source, https://github.com/robertmeisner/mcp_sqlite_memory_bank
 Project-URL: Issues, https://github.com/robertmeisner/mcp_sqlite_memory_bank/issues
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn>=0.22.0
 Requires-Dist: pydantic>=1.10.0
-Requires-Dist: fastmcp
+Requires-Dist: fastmcp>=2.9.0
 Requires-Dist: sqlalchemy>=2.0.0
 Requires-Dist: sentence-transformers>=2.2.0
 Requires-Dist: torch>=1.9.0
@@ -126,10 +126,10 @@ Restart your IDE and try asking your AI assistant:
 
 SQLite Memory Bank v1.4.0+ provides full Model Context Protocol (MCP) compliance with advanced features for enhanced LLM and agent integration:
 
-### 🔧 MCP Tools (20 Available)
+### 🔧 MCP Tools (23 Available)
 Organized into logical categories for easy discovery:
 - **Schema Management** (6 tools): Table creation, modification, and inspection
-- **Data Operations** (5 tools): CRUD operations with validation
+- **Data Operations** (8 tools): CRUD operations with validation and batch processing
 - **Search & Discovery** (2 tools): Content search and exploration
 - **Semantic Search** (5 tools): AI-powered natural language content discovery
 - **Analytics** (2 tools): Memory bank insights and statistics
@@ -175,7 +175,7 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 | `describe_table` | Get schema details | `table_name` (str) | None |
 | `list_all_columns` | List all columns for all tables | None | None |
 
-### Data Operations Tools (5 tools)
+### Data Operations Tools (8 tools)
 
 | Tool | Description | Required Parameters | Optional Parameters |
 |------|-------------|---------------------|---------------------|
@@ -184,6 +184,9 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 | `update_rows` | Update existing rows | `table_name` (str), `data` (dict), `where` (dict) | None |
 | `delete_rows` | Delete rows from table | `table_name` (str), `where` (dict) | None |
 | `run_select_query` | Run safe SELECT query | `table_name` (str) | `columns` (list[str]), `where` (dict), `limit` (int) |
+| `upsert_memory` | Smart update or create memory record | `table_name` (str), `data` (dict), `match_columns` (list[str]) | None |
+| `batch_create_memories` | Efficiently create multiple memory records | `table_name` (str), `data_list` (list[dict]) | `match_columns` (list[str]), `use_upsert` (bool) |
+| `batch_delete_memories` | Delete multiple memory records efficiently | `table_name` (str), `conditions_list` (list[dict]) | `match_mode` (str) |
 
 ### Search & Discovery Tools (2 tools)
 
@@ -211,6 +214,51 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 
 Each tool validates inputs and returns consistent response formats with success/error indicators and appropriate data payloads.
 
+## 🚀 Batch Operations & Smart Memory Management
+
+SQLite Memory Bank provides powerful batch operations for efficient memory management:
+
+### Smart Memory Updates
+- **`upsert_memory`**: Intelligent update-or-create for preventing duplicates
+- **Duplicate Prevention**: Uses match columns to find existing records
+- **Flexible Matching**: Specify which columns to match for finding existing records
+
+### Efficient Batch Processing
+- **`batch_create_memories`**: Create multiple records in a single operation
+- **Smart vs Fast Modes**: Choose between upsert logic (prevents duplicates) or fast insertion
+- **Partial Success Handling**: Continues processing even if some records fail
+- **Detailed Feedback**: Returns counts for created, updated, and failed records
+
+### Flexible Batch Deletion
+- **`batch_delete_memories`**: Delete multiple records with complex conditions
+- **Flexible Matching**: Support for OR (match_any) and AND (match_all) logic
+- **Condition Lists**: Delete based on multiple different criteria
+- **Safe Operations**: Validates conditions before deletion
+
+### Usage Examples
+
+```python
+# Smart memory upsert - prevents duplicates
+upsert_memory('technical_decisions', {
+    'decision_name': 'API Design',
+    'chosen_approach': 'REST APIs',
+    'rationale': 'Better discoverability for LLMs'
+}, match_columns=['decision_name'])
+
+# Batch create with duplicate prevention
+batch_create_memories('project_insights', [
+    {'category': 'performance', 'insight': 'Database indexing'},
+    {'category': 'security', 'insight': 'Input validation'},
+    {'category': 'architecture', 'insight': 'Microservice patterns'}
+], match_columns=['category', 'insight'], use_upsert=True)
+
+# Batch delete with flexible conditions
+batch_delete_memories('old_notes', [
+    {'status': 'archived'},
+    {'created_date': '2023-01-01', 'priority': 'low'}
+], match_mode='match_any')  # Delete if ANY condition matches
+```
+
 ---
 
 ## Transport Modes

{mcp_sqlite_memory_bank-1.5.1 → mcp_sqlite_memory_bank-1.6.0}/README.md

@@ -100,10 +100,10 @@ Restart your IDE and try asking your AI assistant:
 
 SQLite Memory Bank v1.4.0+ provides full Model Context Protocol (MCP) compliance with advanced features for enhanced LLM and agent integration:
 
-### 🔧 MCP Tools (20 Available)
+### 🔧 MCP Tools (23 Available)
 Organized into logical categories for easy discovery:
 - **Schema Management** (6 tools): Table creation, modification, and inspection
-- **Data Operations** (5 tools): CRUD operations with validation
+- **Data Operations** (8 tools): CRUD operations with validation and batch processing
 - **Search & Discovery** (2 tools): Content search and exploration
 - **Semantic Search** (5 tools): AI-powered natural language content discovery
 - **Analytics** (2 tools): Memory bank insights and statistics
@@ -149,7 +149,7 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 | `describe_table` | Get schema details | `table_name` (str) | None |
 | `list_all_columns` | List all columns for all tables | None | None |
 
-### Data Operations Tools (5 tools)
+### Data Operations Tools (8 tools)
 
 | Tool | Description | Required Parameters | Optional Parameters |
 |------|-------------|---------------------|---------------------|
@@ -158,6 +158,9 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 | `update_rows` | Update existing rows | `table_name` (str), `data` (dict), `where` (dict) | None |
 | `delete_rows` | Delete rows from table | `table_name` (str), `where` (dict) | None |
 | `run_select_query` | Run safe SELECT query | `table_name` (str) | `columns` (list[str]), `where` (dict), `limit` (int) |
+| `upsert_memory` | Smart update or create memory record | `table_name` (str), `data` (dict), `match_columns` (list[str]) | None |
+| `batch_create_memories` | Efficiently create multiple memory records | `table_name` (str), `data_list` (list[dict]) | `match_columns` (list[str]), `use_upsert` (bool) |
+| `batch_delete_memories` | Delete multiple memory records efficiently | `table_name` (str), `conditions_list` (list[dict]) | `match_mode` (str) |
 
 ### Search & Discovery Tools (2 tools)
 
@@ -185,6 +188,51 @@ All tools are designed for explicit, discoverable use by LLMs, agents, and devel
 
 Each tool validates inputs and returns consistent response formats with success/error indicators and appropriate data payloads.
 
+## 🚀 Batch Operations & Smart Memory Management
+
+SQLite Memory Bank provides powerful batch operations for efficient memory management:
+
+### Smart Memory Updates
+- **`upsert_memory`**: Intelligent update-or-create for preventing duplicates
+- **Duplicate Prevention**: Uses match columns to find existing records
+- **Flexible Matching**: Specify which columns to match for finding existing records
+
+### Efficient Batch Processing
+- **`batch_create_memories`**: Create multiple records in a single operation
+- **Smart vs Fast Modes**: Choose between upsert logic (prevents duplicates) or fast insertion
+- **Partial Success Handling**: Continues processing even if some records fail
+- **Detailed Feedback**: Returns counts for created, updated, and failed records
+
+### Flexible Batch Deletion
+- **`batch_delete_memories`**: Delete multiple records with complex conditions
+- **Flexible Matching**: Support for OR (match_any) and AND (match_all) logic
+- **Condition Lists**: Delete based on multiple different criteria
+- **Safe Operations**: Validates conditions before deletion
+
+### Usage Examples
+
+```python
+# Smart memory upsert - prevents duplicates
+upsert_memory('technical_decisions', {
+    'decision_name': 'API Design',
+    'chosen_approach': 'REST APIs',
+    'rationale': 'Better discoverability for LLMs'
+}, match_columns=['decision_name'])
+
+# Batch create with duplicate prevention
+batch_create_memories('project_insights', [
+    {'category': 'performance', 'insight': 'Database indexing'},
+    {'category': 'security', 'insight': 'Input validation'},
+    {'category': 'architecture', 'insight': 'Microservice patterns'}
+], match_columns=['category', 'insight'], use_upsert=True)
+
+# Batch delete with flexible conditions
+batch_delete_memories('old_notes', [
+    {'status': 'archived'},
+    {'created_date': '2023-01-01', 'priority': 'low'}
+], match_mode='match_any')  # Delete if ANY condition matches
+```
+
 ---
 
 ## Transport Modes

{mcp_sqlite_memory_bank-1.5.1 → mcp_sqlite_memory_bank-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp_sqlite_memory_bank"
-version = "1.5.1"
+version = "1.6.0"
 description = "A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers with semantic search capabilities."
 authors = [
     { name="Robert Meisner", email="robert@catchit.pl" }
@@ -12,7 +12,7 @@ authors = [
 license = "MIT"
 license-files = ["LICENSE"]
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 classifiers = [
     "Programming Language :: Python :: 3",
     "Operating System :: OS Independent",
@@ -21,7 +21,7 @@ dependencies = [
     "fastapi>=0.100.0",
     "uvicorn>=0.22.0",
     "pydantic>=1.10.0",
-    "fastmcp",
+    "fastmcp>=2.9.0",
     "sqlalchemy>=2.0.0",
     "sentence-transformers>=2.2.0",
     "torch>=1.9.0",
@@ -43,3 +43,18 @@ test = ["pytest"]
 [tool.setuptools.packages.find]
 where = ["src"]
 exclude = ["*__pycache__*", "*.pyc", "*.pyo"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+# Temporarily exclude files with type issues until separate type safety PR
+[[tool.mypy.overrides]]
+module = [
+    "mcp_sqlite_memory_bank.tools.discovery",
+    "mcp_sqlite_memory_bank.tools.analytics"
+]
+ignore_errors = true

{mcp_sqlite_memory_bank-1.5.1 → mcp_sqlite_memory_bank-1.6.0}/src/mcp_sqlite_memory_bank/__init__.py

@@ -8,7 +8,7 @@ Cursor, and other LLM-powered tools to interact with structured data in a
 safe, explicit, and extensible way.
 
 Author: Robert Meisner
-Version: 0.1.0
+Version: 1.6.0
 License: MIT
 """
 
@@ -93,7 +93,7 @@ __all__ = [
     "explore_tables",
     "add_embeddings",
     "semantic_search",
-    "find_related", 
+    "find_related",
     "smart_search",
     "embedding_stats",
     "auto_semantic_search",

{mcp_sqlite_memory_bank-1.5.1 → mcp_sqlite_memory_bank-1.6.0}/src/mcp_sqlite_memory_bank/__main__.py

@@ -11,29 +11,35 @@ import sys
 import os
 
 # Add the project root to Python path to avoid import issues
-project_root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+project_root = os.path.dirname(
+    os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+)
 if project_root not in sys.path:
     sys.path.insert(0, project_root)
 
 # Configure logging before any other imports
 logging.basicConfig(
-    level=logging.INFO, 
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
 )
 
-def main():
+
+def main() -> None:
     """Main entry point for the MCP server."""
     try:
         # Import here to avoid circular import issues
         from .server import app, DB_PATH
-        
+
         # Handle help argument
         if "--help" in sys.argv or "-h" in sys.argv:
             print("SQLite Memory Bank MCP Server")
             print("Usage: python -m src.mcp_sqlite_memory_bank")
             print("")
-            print("This starts the SQLite Memory Bank as an MCP (Model Context Protocol) server.")
-            print("The server communicates via STDIO and provides memory management tools")
+            print(
+                "This starts the SQLite Memory Bank as an MCP (Model Context Protocol) server."
+            )
+            print(
+                "The server communicates via STDIO and provides memory management tools"
+            )
             print("for LLMs and AI agents.")
             print("")
             print(f"Database location: {DB_PATH}")
@@ -41,13 +47,15 @@ def main():
             print("Environment variables:")
             print("  DB_PATH: Override the default database path")
             return
-        
+
         # Log startup information
-        logging.info(f"Starting SQLite Memory Bank MCP server with database at {DB_PATH}")
-        
+        logging.info(
+            f"Starting SQLite Memory Bank MCP server with database at {DB_PATH}"
+        )
+
         # Run the FastMCP app in stdio mode for MCP clients
         app.run(transport="stdio")
-        
+
     except KeyboardInterrupt:
         logging.info("Server stopped by user")
         sys.exit(0)
@@ -55,5 +63,6 @@ def main():
         logging.error(f"Failed to start MCP server: {e}")
         sys.exit(1)
 
+
 if __name__ == "__main__":
     main()