Key Features
Cross-Platform Wrapper Scripts for Orphan Process Cleanup
Eliminates SQLite "database is locked" errors caused by orphaned processes when Claude Desktop/Code crashes.
- ๐งน Automatic Orphan Detection - Identifies orphaned MCP memory processes after crashes
- Unix: Detects processes adopted by init/launchd (ppid == 1)
- Windows: Detects processes whose parent no longer exists
- ๐ก๏ธ Database Lock Prevention - Cleans up orphaned processes before starting new server instance
- ๐ Cross-Platform Wrappers
- Python:
memory_wrapper_cleanup.py(universal, recommended) - Bash:
memory_wrapper_cleanup.sh(macOS/Linux native) - PowerShell:
memory_wrapper_cleanup.ps1(Windows native)
- Python:
- ๐ Safe Cleanup - Only terminates actual orphans, preserves active sessions
- ๐ Comprehensive Documentation - README_CLEANUP_WRAPPER.md with installation guide, troubleshooting, and technical details
- ๐ง 22 Unit Tests - Full test coverage with platform-specific validation
Security Enhancements
- Removed `shell=True` from subprocess calls (Bandit B602/B604)
- All 3 HIGH-severity security issues resolved
- Tests: 22 passed, 2 skipped (Windows-specific tests on macOS)
Installation
# Update to latest version
pip install --upgrade mcp-memory-service
# Or install from source
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service
pip install -e .Usage
See `scripts/run/README_CLEANUP_WRAPPER.md` for detailed usage instructions.
Full Changelog
https://github.com/doobidoo/mcp-memory-service/blob/main/CHANGELOG.md#8740---2026-01-09
๐ค Generated with Claude Code