mcp-sqlite-memory-bank 1.2.2__py3-none-any.whl → 1.2.4__py3-none-any.whl

mcp_sqlite_memory_bank/server.py

@@ -809,20 +809,6 @@ Available tools:
 - run_select_query: Run a safe SELECT query (no arbitrary SQL)
 """
 
-# Main entrypoint for direct execution
-if __name__ == "__main__":
-    # Configure logging
-    logging.basicConfig(
-        level=logging.INFO,
-        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
-    )
-
-    # Log startup information
-    logging.info(f"Starting SQLite Memory Bank with database at {DB_PATH}")
-
-    # Run the FastMCP app
-    app.run()
-
 # Implementation functions for backwards compatibility with tests
 
 
@@ -951,11 +937,8 @@ def _read_rows_impl(table_name: str,
 
 
 def _update_rows_impl(table_name: str,
-                      data: Dict[str,
-                                 Any],
-                      where: Optional[Dict[str,
-                                           Any]] = None) -> Dict[str,
-                                                                 Any]:
+                      data: Dict[str, Any],
+                      where: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
     """Legacy implementation function for tests."""
     # Accepts any table created by agents; validates columns dynamically
     where = where or {}
@@ -1097,13 +1080,27 @@ __all__ = [
     '_delete_rows_impl']
 
 
+def mcp_server():
+    """Entry point for MCP stdio server (for uvx and package installations)."""
+    # Configure logging for MCP server
+    logging.basicConfig(
+        level=logging.INFO,
+        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+
+    # Log startup information
+    logging.info(f"Starting SQLite Memory Bank MCP server with database at {DB_PATH}")
+
+    # Run the FastMCP app in stdio mode
+    app.run()
+
+
 def main():
-    """Main entry point for running the MCP SQLite Memory Bank server."""
+    """Alternative entry point for HTTP server mode (development/testing only)."""
     import uvicorn
     import argparse
-    import os
 
-    parser = argparse.ArgumentParser(description="Run MCP SQLite Memory Bank Server")
+    parser = argparse.ArgumentParser(description="Run MCP SQLite Memory Bank Server in HTTP mode")
     parser.add_argument("--host", default="127.0.0.1", help="Host to bind to")
     parser.add_argument("--port", type=int, default=8000, help="Port to bind to")
     parser.add_argument("--db-path", help="Path to SQLite database file")
@@ -1115,9 +1112,9 @@ def main():
     if args.db_path:
         global DB_PATH
         DB_PATH = args.db_path
-        os.environ["SQLITE_MEMORY_BANK_DB_PATH"] = args.db_path
+        os.environ["DB_PATH"] = args.db_path
 
-    print(f"Starting MCP SQLite Memory Bank server on {args.host}:{args.port}")
+    print(f"Starting MCP SQLite Memory Bank server in HTTP mode on {args.host}:{args.port}")
     print(f"Database path: {DB_PATH}")
     print("Available at: http://localhost:8000/docs")
 
@@ -1130,4 +1127,14 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    # Configure logging
+    logging.basicConfig(
+        level=logging.INFO,
+        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+
+    # Log startup information
+    logging.info(f"Starting SQLite Memory Bank with database at {DB_PATH}")
+
+    # Run the FastMCP app in stdio mode for MCP clients
+    app.run()

{mcp_sqlite_memory_bank-1.2.2.dist-info → mcp_sqlite_memory_bank-1.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp_sqlite_memory_bank
-Version: 1.2.2
+Version: 1.2.4
 Summary: A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers.
 Author-email: Robert Meisner <robert@catchit.pl>
 License-Expression: MIT
@@ -45,6 +45,60 @@ This project provides a robust, discoverable API for creating, exploring, and ma
 
 ---
 
+## Quick Start
+
+Get started with SQLite Memory Bank in your IDE in under 2 minutes:
+
+### 1. Install and Run
+```bash
+# Install uvx if you don't have it
+pip install uvx
+
+# Run SQLite Memory Bank
+uvx mcp-sqlite-memory-bank
+```
+
+### 2. Configure Your IDE
+
+**VS Code / Cursor:** Add to `.vscode/mcp.json`:
+```jsonc
+{
+  "servers": {
+    "SQLite_Memory": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["--refresh", "mcp-sqlite-memory-bank"],
+      "env": {
+        "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop:** Add to `claude_desktop_config.json`:
+```jsonc
+{
+  "mcpServers": {
+    "sqlite_memory": {
+      "command": "uvx",
+      "args": ["mcp-sqlite-memory-bank"],
+      "env": {
+        "DB_PATH": "/path/to/your/memory.db"
+      }
+    }
+  }
+}
+```
+
+### 3. Test It
+Restart your IDE and try asking your AI assistant:
+> "Create a table called 'notes' with columns 'id' (integer, primary key) and 'content' (text). Then add a note saying 'Hello SQLite Memory Bank!'"
+
+✅ You should see the AI using the SQLite Memory Bank tools to create the table and add the note!
+
+---
+
 ## Features
 
 - **Dynamic Table Management:** Create, list, describe, rename, and drop tables at runtime
@@ -86,6 +140,22 @@ Each tool validates inputs and returns consistent response formats with success/
 
 ---
 
+## Transport Modes
+
+### Stdio Mode (Default)
+- **Use case**: MCP clients (VS Code, Claude Desktop, etc.)
+- **Protocol**: JSON-RPC over stdin/stdout
+- **Command**: `uvx mcp-sqlite-memory-bank`
+- **Benefits**: Direct integration with AI assistants and IDEs
+
+### HTTP Mode (Development)
+- **Use case**: Development, testing, web APIs
+- **Protocol**: HTTP REST API
+- **Command**: `python -m mcp_sqlite_memory_bank.server main --port 8000`
+- **Benefits**: Web browser access, curl testing, API integration
+
+---
+
 ## Installation & Transport Options
 
 **Requirements:**
@@ -111,47 +181,29 @@ python -m pip install --user pipx
 pipx run mcp_sqlite_memory_bank
 ```
 
-### Option 4: Run via UVX
+### Option 4: Run via UVX (Recommended for MCP clients)
 ```bash
-# Install UVX if you don't have it
-curl -fsSL https://uvx.zip/install.sh | bash
-
-# Run directly without installation
-uvx run mcp_sqlite_memory_bank
+# Run directly with latest version (recommended)
+uvx mcp-sqlite-memory-bank
 
-# Or, specify a version
-uvx run mcp_sqlite_memory_bank@latest
+# Force refresh to get latest updates
+uvx --refresh mcp-sqlite-memory-bank
 ```
 
-### Option 5: Docker (Containerized) # Coming soon - not yet implemented
-```bash
-# Pull the image
-docker pull robertmeisner/mcp_sqlite_memory_bank:latest
-
-# Run with stdio transport (for Claude Desktop)
-docker run -i --rm \
-  --mount type=bind,src=/path/to/data/dir,dst=/data \
-  robertmeisner/mcp_sqlite_memory_bank:latest stdio
-
-# Run with HTTP transport (for API access) 
-docker run -p 8000:8000 --rm \
-  --mount type=bind,src=/path/to/data/dir,dst=/data \
-  robertmeisner/mcp_sqlite_memory_bank:latest http
-```
+---
 
 ### Transport Options
 
-SQLite Memory Bank currently supports:
-
-- **stdio** (default): For direct integration with Claude Desktop and other MCP clients
+SQLite Memory Bank currently supports **stdio transport** for MCP clients:
 
-Planned transport options (not yet implemented):
-- **http**: For web access and API usage
-- **streamable-http**: For the latest MCP specification
+**Stdio Transport (Default - for MCP clients like VS Code, Claude Desktop):**
+```bash
+uvx mcp-sqlite-memory-bank
+```
 
-Run with the default transport:
+**HTTP Transport (Development/Testing only):**
 ```bash
-python -m mcp_sqlite_memory_bank.server
+python -m mcp_sqlite_memory_bank.server main --host 127.0.0.1 --port 8000
 ```
 
 ---
@@ -175,11 +227,6 @@ DB_PATH=./test.db
 
 ### VS Code Integration
 
-#### Quick Install
-[Install with Python Module in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite-memory&config=%7B%22command%22%3A%22python%22%2C%22args%22%3A%5B%22-m%22%2C%22mcp_sqlite_memory_bank%22%5D%7D)
-
-[Install with Docker in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite-memory&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22--mount%22%2C%22type%3Dbind%2Csrc%3D%24%7BworkspaceFolder%7D%2Cdst%3D%2Fdata%22%2C%22robertmeisner%2Fmcp_sqlite_memory_bank%3Alatest%22%5D%7D)
-
 #### Manual Configuration
 
 Add or update `.vscode/mcp.json` in your project root:
@@ -188,23 +235,16 @@ Add or update `.vscode/mcp.json` in your project root:
   "servers": {
     "SQLite_Memory": {
       "type": "stdio",
-      "command": "python",
-      "args": ["-m", "mcp_sqlite_memory_bank.server"],
+      "command": "uvx",
+      "args": ["--refresh", "mcp-sqlite-memory-bank"],
       "env": {
-        "DB_PATH": "${workspaceFolder}/data/memory.db"
+        "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
       }
     }
   }
 }
 ```
 
-## FastMCP Integration (Planned)
-
-```bash
-# Coming soon - not yet implemented
-fastmcp install mcp_sqlite_memory_bank/server.py --name "SQLite Memory Bank"
-```
-
 ### Claude Desktop Integration
 
 Add to your `claude_desktop_config.json`:
@@ -213,8 +253,8 @@ Add to your `claude_desktop_config.json`:
 {
   "mcpServers": {
     "sqlite_memory": {
-      "command": "python",
-      "args": ["-m", "mcp_sqlite_memory_bank.server"],
+      "command": "uvx",
+      "args": ["mcp-sqlite-memory-bank"],
       "env": {
         "DB_PATH": "/path/to/your/memory.db"
       }
@@ -223,28 +263,6 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-#### Docker Option for Claude Desktop
-
-```jsonc
-{
-  "mcpServers": {
-    "sqlite_memory": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "--mount", "type=bind,src=/path/to/data/dir,dst=/data",
-        "robertmeisner/mcp_sqlite_memory_bank:latest"
-      ],
-      "env": {
-        "DB_PATH": "/data/memory.db"
-      }
-    }
-  }
-}
-```
-
 - Open your project in VS Code, Cursor, or Claude Desktop. The MCP server will be auto-discovered by Copilot Chat, Cursor, Claude, or any compatible agent.
 - Use natural language to create tables, store notes, or build knowledge graphs.
 
@@ -252,36 +270,28 @@ Add to your `claude_desktop_config.json`:
 
 ## Running the Server
 
-### Transport Options
+### MCP Stdio Mode (Recommended)
 
-SQLite Memory Bank currently supports stdio transport only:
+For use with VS Code, Claude Desktop, and other MCP clients:
 
-**Stdio Transport (Default - for Claude Desktop):**
 ```bash
-python -m mcp_sqlite_memory_bank.server
-```
+# Run with uvx (automatically gets latest version)
+uvx mcp-sqlite-memory-bank
 
-**HTTP Transport (REST API - Planned):**
-```bash
-# Coming soon - not yet implemented
-python -m mcp_sqlite_memory_bank.server http --port 8000
+# Force refresh to latest version
+uvx --refresh mcp-sqlite-memory-bank
 ```
 
-**Streamable HTTP Transport (Latest MCP Spec - Planned):**
-```bash
-# Coming soon - not yet implemented
-python -m mcp_sqlite_memory_bank.server streamable-http --port 8000
-```
+### Development/Testing Modes
 
-**With the example runner:**
+**HTTP Server Mode (for development and testing):**
 ```bash
-python examples/run_server.py
+python -m mcp_sqlite_memory_bank.server main --port 8000
 ```
 
-**With FastMCP (Planned):**
+**Direct Python Module:**
 ```bash
-# Coming soon - not yet implemented
-fastmcp install mcp_sqlite_memory_bank/server.py --name "SQLite Memory Bank"
+python -m mcp_sqlite_memory_bank.server
 ```
 
 ---
@@ -403,6 +413,43 @@ For a complete agent memory implementation example, see [examples/agent_memory_e
 
 ---
 
+## Troubleshooting
+
+### Common MCP Connection Issues
+
+**Server not starting / Connection timeout:**
+```bash
+# Force refresh uvx cache and try again
+uvx --refresh mcp-sqlite-memory-bank
+
+# Check if the command works directly
+uvx mcp-sqlite-memory-bank --help
+```
+
+**VS Code: "Server exited before responding to initialize request":**
+1. Check the MCP configuration in `.vscode/mcp.json`
+2. Ensure `uvx` is installed and in your PATH
+3. Try restarting VS Code or running "MCP: Restart Server" from Command Palette
+
+**Tools not appearing in IDE:**
+1. Verify the server is running: `uvx mcp-sqlite-memory-bank` should start without errors
+2. Check that `"type": "stdio"` is set in your MCP configuration
+3. Restart your IDE or reload MCP configuration
+
+**Database permission errors:**
+- Ensure the directory for `DB_PATH` exists and is writable
+- Check file permissions on the SQLite database file
+- Use absolute paths in `DB_PATH` to avoid path resolution issues
+
+**Package not found / outdated version:**
+```bash
+# Clear uvx cache completely
+uvx cache remove mcp-sqlite-memory-bank
+uvx mcp-sqlite-memory-bank
+```
+
+---
+
 
 ## Running Tests
 

mcp_sqlite_memory_bank-1.2.4.dist-info/RECORD

@@ -0,0 +1,11 @@
+mcp_sqlite_memory_bank/__init__.py,sha256=l2045g6NL0NYoX0zMUjL5gDJHb4rI3l3gNUOYeACyBU,2293
+mcp_sqlite_memory_bank/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_sqlite_memory_bank/server.py,sha256=xZFbFtR40Fq5mK_7B0dQNKtrZhQD8DvHkQlVTDrXTLw,38998
+mcp_sqlite_memory_bank/types.py,sha256=86xN1bv-WaIu_Oz1_RFjRP7wsZdc6CHL_ntCGqn0eDI,4439
+mcp_sqlite_memory_bank/utils.py,sha256=YHUFbZL0AJ0jjQnlQSVYJpBi4Bmeu7M-7tcyS82gxts,6574
+mcp_sqlite_memory_bank-1.2.4.dist-info/licenses/LICENSE,sha256=KPr7eFgCJqQIjeSAcwRafbjcgm-10zkrJ7MFoTOGJQg,1092
+mcp_sqlite_memory_bank-1.2.4.dist-info/METADATA,sha256=yuO3ewomT2ZJrimZ6uoLlnfbrTilycDBLAJwHJcG0D0,24513
+mcp_sqlite_memory_bank-1.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_sqlite_memory_bank-1.2.4.dist-info/entry_points.txt,sha256=S9yGWiCe8f_rgcGCgbwEAX2FfJ9jXWxcc4K4Jenbcn8,150
+mcp_sqlite_memory_bank-1.2.4.dist-info/top_level.txt,sha256=xQ8MTGECpWMR-9DV4H8mMqaSoZqE-C8EvpOg9E2U1wM,23
+mcp_sqlite_memory_bank-1.2.4.dist-info/RECORD,,

mcp_sqlite_memory_bank-1.2.4.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+mcp-sqlite-memory-bank = mcp_sqlite_memory_bank.server:mcp_server
+mcp_sqlite_memory_bank = mcp_sqlite_memory_bank.server:mcp_server

mcp_sqlite_memory_bank-1.2.2.dist-info/RECORD

@@ -1,11 +0,0 @@
-mcp_sqlite_memory_bank/__init__.py,sha256=l2045g6NL0NYoX0zMUjL5gDJHb4rI3l3gNUOYeACyBU,2293
-mcp_sqlite_memory_bank/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_sqlite_memory_bank/server.py,sha256=P-JJy-inp-8Pk_iB16-HpQOjebzGdjudbwfLr3GcVaM,38744
-mcp_sqlite_memory_bank/types.py,sha256=86xN1bv-WaIu_Oz1_RFjRP7wsZdc6CHL_ntCGqn0eDI,4439
-mcp_sqlite_memory_bank/utils.py,sha256=YHUFbZL0AJ0jjQnlQSVYJpBi4Bmeu7M-7tcyS82gxts,6574
-mcp_sqlite_memory_bank-1.2.2.dist-info/licenses/LICENSE,sha256=KPr7eFgCJqQIjeSAcwRafbjcgm-10zkrJ7MFoTOGJQg,1092
-mcp_sqlite_memory_bank-1.2.2.dist-info/METADATA,sha256=oVQygDpIB89ihHWwkhPpcCOU27E6h6OQGT2kBkeI2Lo,23640
-mcp_sqlite_memory_bank-1.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_sqlite_memory_bank-1.2.2.dist-info/entry_points.txt,sha256=dsS0KHwObGvPtVoqdIMgBxzDwkcsTbtQvULanheZlM0,138
-mcp_sqlite_memory_bank-1.2.2.dist-info/top_level.txt,sha256=xQ8MTGECpWMR-9DV4H8mMqaSoZqE-C8EvpOg9E2U1wM,23
-mcp_sqlite_memory_bank-1.2.2.dist-info/RECORD,,

mcp_sqlite_memory_bank-1.2.2.dist-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-mcp-sqlite-memory-bank = mcp_sqlite_memory_bank.server:main
-mcp_sqlite_memory_bank = mcp_sqlite_memory_bank.server:main