doobidoo/mcp-memory-service v6.14.0

🛠️ v6.14.0 - Operational Utilities & Backend Synchronization

on GitHub

🛠️ Operational Utilities & Backend Synchronization

This release introduces comprehensive operational utilities for production deployments, enabling bidirectional memory synchronization, service management, and configuration validation. All code quality issues identified by Gemini Code Assist have been addressed with professional-grade improvements.

🔄 New Backend Synchronization Capabilities

Bidirectional Sync Engine

• ✅ sync_memory_backends.py - Core sync logic with intelligent content-based deduplication
• ✅ claude_sync_commands.py - User-friendly CLI wrapper for sync operations
• ✅ Cloudflare ↔ SQLite-vec synchronization with dry-run mode support
• ✅ Comprehensive status reporting and robust error handling
• ✅ Content hashing prevents duplicates across different backends

Service Management Tools

• ✅ memory_service_manager.sh - Complete Linux service management for dual-backend deployments
• ✅ State-based backend detection using /tmp/memory-service-backend.state
• ✅ Environment file management for Cloudflare and SQLite configurations
• ✅ Integrated sync operations and health monitoring capabilities

Configuration Validation

• ✅ validate_config.py - Comprehensive configuration validator and troubleshooting tool
• ✅ Validates Claude Code global configuration (~/.claude.json)
• ✅ Checks Cloudflare credentials and environment setup completeness
• ✅ Detects configuration conflicts and provides actionable solutions

Enhanced Documentation

• ✅ Updated scripts/README.md with comprehensive utility documentation
• ✅ Backend sync references added to main README.md and CLAUDE.md
• ✅ Created Backend-Synchronization-Guide.md wiki page with complete setup guide

💯 Code Quality Improvements (Gemini Code Assist Feedback Addressed)

Eliminated Code Duplication

• ✅ Refactored sync_memory_backends.py to use shared _sync_between_backends() method
• ✅ Reduced ~80 lines of duplicate code, significantly improved maintainability
• ✅ Generic sync logic now supports any backend combination

Cross-Platform Compatibility

• ✅ Replaced hardcoded /home/hkr/ paths with $HOME environment variable
• ✅ Added missing final newlines to all utility scripts for POSIX compliance
• ✅ Improved path handling for Windows/macOS/Linux compatibility

Enhanced Validation & Robustness

• ✅ Improved configuration validation with regex patterns instead of basic string matching
• ✅ Added UTF-8 encoding to all file operations in validate_config.py
• ✅ Fixed .env.sqlite conflict detection logic to exclude intended backup files
• ✅ Better error handling throughout all utility scripts

Better Code Organization

• ✅ Refactored command handling to dictionary-based dispatch pattern
• ✅ Improved scalability for future command additions
• ✅ Enhanced code readability and maintainability

🚀 Production Deployment Features

Real-World Use Cases

• Hybrid Cloud/Local Deployments: Cloudflare primary with SQLite backup strategy
• Disaster Recovery: Automated backup and restore capabilities for memory preservation
• Multi-Machine Sync: Consistent memory sharing across development and production devices
• Development/Production Workflows: Seamless sync between different environments
• Troubleshooting Tools: Professional configuration validation and service management

🎯 Impact & Benefits

• 🎯 Fills critical operational gaps for production MCP Memory Service deployments
• 🚀 Enables advanced deployment strategies (hybrid cloud/local architecture)
• 💻 Simplifies troubleshooting with comprehensive validation and management tools
• ✅ Professional code quality meeting all automated review standards
• 🔄 Supports complex workflows for distributed teams and multi-device setups
• 🛡️ Improves reliability with robust error handling and state management

📦 Quick Start

Installation

# Upgrade to latest version
pip install --upgrade mcp-memory-service

# Verify installation
memory --version
# Should show: MCP Memory Service v6.14.0

Sync Operations

# Check sync status
python scripts/claude_sync_commands.py status

# Backup Cloudflare → SQLite
python scripts/claude_sync_commands.py backup

# Bidirectional sync
python scripts/claude_sync_commands.py sync

# Dry run (preview changes)
python scripts/claude_sync_commands.py dry-run

Service Management (Linux)

# Start with Cloudflare backend
./scripts/memory_service_manager.sh start-cloudflare

# Check service status
./scripts/memory_service_manager.sh status

# Sync memories between backends
./scripts/memory_service_manager.sh sync-both

Configuration Validation

# Validate complete configuration
python scripts/validate_config.py

📋 Files Added/Modified (8)

New Operational Utilities

• scripts/sync_memory_backends.py - Bidirectional sync engine with deduplication
• scripts/claude_sync_commands.py - CLI wrapper for sync operations
• scripts/memory_service_manager.sh - Linux service manager for dual backends
• scripts/validate_config.py - Configuration validator and troubleshooter

Updated Documentation

• scripts/README.md - Comprehensive utility documentation with examples
• README.md - Added troubleshooting references and operational guidance
• CLAUDE.md - Added sync and validation commands for Claude Code users
• Wiki: Backend-Synchronization-Guide.md - Complete setup and deployment guide

This release transforms MCP Memory Service into a production-ready solution with professional operational tooling! 🎉