# Complete Feature List Current setup note (v12.6.0, 2026-11-05). Python 3.11+ is required. [Current capabilities and integrations](https://github.com/doobidoo/mcp-memory-service/blob/main/README.md) is maintained in the repository. Version-labelled examples and benchmarks below describe their original releases. Deprecated MCP tool aliases were removed in v11; use the [migration mapping](https://github.com/doobidoo/mcp-memory-service/blob/main/docs/MIGRATION.md) for older examples. This comprehensive guide showcases all major features of MCP Memory Service, organized by category. Each feature includes its introduction version, key capabilities, usage examples, and unique differentiators. **Quick Stats**: 34 major features | 173 releases over 10 months | 1,700+ memories in production | Zero database locks --- ## Table of Contents 1. [Core Features](#core-features) - Foundation capabilities 2. [Storage & Performance](#storage--performance) - Backend architecture and optimization 3. [Interface & Integration](#interface--integration) - User interfaces and compatibility 4. [Advanced Intelligence](#advanced-intelligence) - AI-powered memory awareness 5. [Performance Features](#performance-features) - Efficiency and optimization 6. [Developer Tools](#developer-tools) - Utilities and APIs 7. [Agent Integrations](#agent-integrations) - Workflow automation 8. [Security & Reliability](#security--reliability) - Production hardening --- ## Core Features ### 1. Semantic Memory Storage (v1.0.0+) **What it does**: Stores and retrieves information using AI-powered semantic search, not just keyword matching. **Key Capabilities**: - Vector embeddings with cosine similarity search - Natural language queries ("What did we decide about authentication?") - Automatic deduplication via content hashing - 5ms read performance (SQLite-vec backend) **Usage Example**: ```bash # Store information claude /memory-store "We decided to use OAuth 2.1 for team collaboration" # Retrieve semantically claude /memory-recall "authentication decisions" # Returns: "We decided to use OAuth 2.1..." ``` **Differentiator**: Vector search finds conceptually related information, not just keyword matches. **Related Docs**: [Integration Guide](03-Integration-Guide.md), [Examples](09-Examples.md) --- ### 2. Multi-Backend Storage System (v2.0.0+) **What it does**: Choose between 3 storage backends optimized for different use cases. **Available Backends**: - **Hybrid** (v6.21.0+, RECOMMENDED): 5ms local SQLite + background Cloudflare sync - **SQLite-vec** (v2.0.0+): Fast local-only (<150MB RAM, 2-3s startup) - **Cloudflare** (v3.0.0+): Global edge distribution with D1 + Vectorize **Key Capabilities**: - Zero database locks (v8.9.0) - concurrent HTTP + MCP access - Automatic WAL mode with proper coordination - Auto-configured SQLite pragmas (`busy_timeout=15000`) - Graceful fallback from cloud to local **Backend Selection**: ```bash # Installation with backend choice python scripts/installation/install.py --storage-backend hybrid # Or via environment variable export MCP_MEMORY_STORAGE_BACKEND=hybrid ``` **Differentiator**: Industry-first zero-lock concurrent access (5/5 writes succeeded in production testing). **Related Docs**: [Installation Guide](01-Installation-Guide.md), [Advanced Configuration](04-Advanced-Configuration.md) --- ### 3. Zero-Configuration Setup (v6.16.0+) **What it does**: One-command installation with automatic platform detection and configuration. **Key Capabilities**: - Interactive backend selection with usage recommendations - Automatic Cloudflare credential setup - Connection testing during installation - Platform hardware detection (CUDA/MPS/DirectML/ROCm) - 98.5% setup success rate **One-Command Installation**: ```bash # Download and run curl -sSL https://raw.githubusercontent.com/doobidoo/mcp-memory-service/main/scripts/installation/install.py | python3 - --storage-backend hybrid ``` **Differentiator**: Fastest setup of any MCP server (2 minutes from download to working system). **Related Docs**: [Installation Guide](01-Installation-Guide.md), [Platform Setup](02-Platform-Setup-Guide.md) --- ## Storage & Performance ### 4. Hybrid Backend Architecture (v6.21.0+) **What it does**: Combines fast local reads (5ms) with automatic cloud backup - best of both worlds. **Key Capabilities**: - **Zero user-facing latency** - All operations execute locally - **Background sync** - Cloud sync every 5 minutes (configurable) - **Graceful offline operation** - Works without internet - **Multi-device synchronization** - Access memories everywhere - **Automatic failover** - Falls back to SQLite-only if Cloudflare unavailable **Configuration**: ```bash export MCP_MEMORY_STORAGE_BACKEND=hybrid export MCP_HYBRID_SYNC_INTERVAL=300 # 5 minutes export MCP_HYBRID_BATCH_SIZE=50 # 50 operations per sync export MCP_HYBRID_SYNC_ON_STARTUP=true # Initial sync on startup ``` **Architecture**: Primary: SQLite-vec (all operations) | Secondary: Cloudflare (background sync) | Service: Async queue with retry logic **Differentiator**: Only MCP server with true hybrid architecture (local speed + cloud persistence). **Related Docs**: [Backend Synchronization Guide](Backend-Synchronization-Guide.md), [Performance Optimization](05-Performance-Optimization.md) --- ### 5. Production-Ready Reliability (v8.9.0+) **What it does**: Concurrent access without database lock errors. **Key Improvements**: - WAL mode with automatic checkpoint management - Auto-configured SQLite pragmas via environment variables - Proper connection pooling and coordination - Database health monitoring **Configuration**: ```bash # Auto-configured in v8.9.0+ export MCP_MEMORY_SQLITE_PRAGMAS="busy_timeout=15000,journal_mode=WAL,synchronous=NORMAL" ``` **Production Validation**: - 5/5 concurrent writes succeeded (HTTP server + MCP client simultaneously) - 1,700+ memories in active production - Zero lock errors after v8.9.0 deployment **Critical Note**: After adding pragmas to `.env`, restart ALL servers (HTTP + MCP). Pragmas are per-connection, not global. **Differentiator**: Industry-first zero-lock guarantee for concurrent MCP + HTTP access. **Related Docs**: [TROUBLESHOOTING](07-TROUBLESHOOTING.md#database-lock-prevention) --- ### 6. Natural Language Time Queries (v4.0.0+) **What it does**: Query memories using human language for time ranges. **Supported Expressions**: - Relative: "yesterday", "last week", "2 days ago" - Seasonal: "last summer", "this month", "last January" - Events: "spring", "Christmas", "Thanksgiving" - Time-of-day: "morning", "evening", "yesterday afternoon" **Usage Examples**: ```bash # MCP tool claude /memory-recall "last week" # REST API curl http://127.0.0.1:8000/api/search/by-time \ -H "X-API-Key: your-key" \ -d '{"query": "last summer"}' ``` **Differentiator**: Most comprehensive natural language time parsing in any MCP server. **Related Docs**: [Examples](09-Examples.md), [Integration Guide](03-Integration-Guide.md) --- ### 7. Performance Benchmarks (Production) **Real-World Metrics**: - **Read Performance**: 5ms (SQLite-vec local) - **Semantic Search**: <500ms (local & HTTP) - **Dashboard Page Load**: 25ms - **Dashboard Search**: <100ms - **Analytics Load**: <2s (2,222 memories) - **Memory Overhead**: <150MB RAM - **Startup Time**: 2-3s (SQLite-vec), 1-2s (Cloudflare) **Scale Validation**: - 1,700+ memories actively used in production - 2,222 memories tested in dashboard analytics - Zero lock errors, zero data loss - 100% knowledge retention across sessions **Related Docs**: [Performance Optimization](05-Performance-Optimization.md) --- ### 8. Platform Hardware Optimization (v2.0.0+) **What it does**: Automatic detection and optimization for CPU architecture. **Supported Platforms**: - **macOS**: MPS (Apple Silicon), CPU (Intel) - **Windows**: CUDA, DirectML, CPU - **Linux**: CUDA, ROCm, CPU **Installation Modes**: ```bash # Lightweight (default, ONNX embeddings) python install.py --storage-backend hybrid # Full ML (PyTorch, larger footprint) python install.py --storage-backend hybrid --with-ml ``` **Differentiator**: Only MCP server with automatic hardware acceleration detection. **Related Docs**: [Platform Setup Guide](02-Platform-Setup-Guide.md) --- ### 9. Memory Consolidation System (v5.0.0+) **What it does**: Dream-inspired algorithms to merge and compress related memories. **Key Capabilities**: - Clustering related memories by topic - Decay algorithm for forgetting old information - Association discovery between concepts - Health monitoring and metrics **Features**: - Automatic deduplication via content hashing - Time-based relevance scoring - Tag-based organization - 24 core memory types (standardized taxonomy) **Maintenance**: ```bash # Find and consolidate duplicates python scripts/maintenance/find_all_duplicates.py # Consolidate memory types python scripts/maintenance/consolidate_memory_types.py --dry-run ``` **Differentiator**: Inspired by human sleep consolidation patterns (REM/SWS cycles). **Related Docs**: [Development Reference](06-Development-Reference.md) --- ## Interface & Integration ### 10. Interactive Web Dashboard (v8.6.0+) **What it does**: Complete memory management via beautiful web UI. **Access**: `http://127.0.0.1:8888/` (default port) **Key Features**: - **Document Upload**: Drag-and-drop PDF/DOCX/PPTX ingestion with progress tracking - **Real-Time Search**: Semantic, tag, and time-based search (<100ms) - **Analytics Dashboard**: Memory growth charts, type distribution, activity patterns - **Mobile Responsive**: Optimized for 768px and 1024px breakpoints - **Live Updates**: Server-Sent Events (SSE) for real-time notifications - **CRUD Operations**: Create, read, update, delete memories via UI **Performance**: - 25ms page load - <100ms search operations - <2s analytics with 2,222 memories **Configuration**: ```bash export MCP_HTTP_ENABLED=true # Enable HTTP server export MCP_HTTP_PORT=8888 # Custom port export MCP_HTTPS_ENABLED=true # Enable HTTPS (production) export MCP_API_KEY="your-secure-key" # API authentication ``` **Security**: XSS prevention, input validation, path traversal protection, API key authentication. **Differentiator**: Only MCP server with full-featured web dashboard and analytics. **Related Docs**: [Advanced Configuration](04-Advanced-Configuration.md), [OAuth 2.1 Setup](OAuth-2.1-Setup-Guide.md) --- ### 11. OAuth 2.1 Team Collaboration (v7.0.0+) **What it does**: Enterprise authentication with Dynamic Client Registration (RFC 7591). **Key Capabilities**: - **Zero-configuration client registration** - Automatic via RFC 7591 - **JWT access tokens** - Scope validation and expiration - **Auto-discovery endpoints** - RFC 8414 compliance - **Multi-auth support** - OAuth + API keys simultaneously - **Team collaboration** - Shared memory access via Claude Code HTTP transport **Production Impact**: - 65% token reduction vs traditional MCP - 96.7% faster context setup (15min → 30sec) - Multiple team members can access shared memory **Setup**: ```bash # Enable OAuth in HTTP server export MCP_OAUTH_ENABLED=true export MCP_OAUTH_CLIENT_ID="auto-generated" export MCP_OAUTH_ISSUER="http://127.0.0.1:8888" ``` **Differentiator**: First and only MCP server with full OAuth 2.1 compliance and Dynamic Client Registration. **Related Docs**: [OAuth 2.1 Setup Guide](OAuth-2.1-Setup-Guide.md), [Integration Guide](03-Integration-Guide.md) --- ### 12. Universal Client Compatibility (v1.0.0+) **What it does**: Works with 13+ AI applications via MCP protocol + HTTP API. **Supported Clients**: - **Claude Desktop** (native MCP stdio transport) - **Claude Code** (HTTP transport with OAuth) - **VS Code** (MCP extension) - **Cursor** (MCP extension) - **Continue** (MCP extension) - **Zed** (MCP protocol) - **Any HTTP client** (curl, Postman, Python requests) **Transports**: - **MCP stdio** - Claude Desktop, local clients - **HTTP + OAuth** - Claude Code team collaboration - **REST API** - Web applications, mobile apps **Configuration Examples**: ```json // Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) { "mcpServers": { "memory": { "command": "uv", "args": ["run", "memory", "server"] } } } // Claude Code (HTTP transport) { "memory-http": { "url": "http://127.0.0.1:8888/sse" } } ``` **Differentiator**: Widest client compatibility of any MCP server (stdio + HTTP + REST). **Related Docs**: [Integration Guide](03-Integration-Guide.md), [Platform Setup](02-Platform-Setup-Guide.md) --- ### 13. Document Ingestion System (v8.6.0+) **What it does**: Upload and parse documents into searchable memory chunks. **Supported Formats**: - **PDF** (PyPDF2/pdfplumber, enhanced with LlamaParse) - **TXT, MD, JSON** (native parsers) - **DOCX, PPTX** (via optional semtools) **Key Capabilities**: - Interactive web UI with progress tracking - Intelligent chunking (respects paragraph boundaries) - Smart tagging with validation (max 100 chars) - Batch directory ingestion - Optional OCR and table extraction (semtools) **Usage**: ```bash # Single document via CLI claude /memory-ingest document.pdf --tags documentation # Batch directory ingestion claude /memory-ingest-dir ./docs --tags knowledge-base # Web UI: Drag-and-drop at http://127.0.0.1:8888/ ``` **REST API Endpoints** (7 new in v8.6.0): - `/api/documents/upload` - Upload document - `/api/documents/{id}` - Get document details - `/api/documents/{id}/chunks` - List chunks - `/api/documents/{id}/download` - Download original **Security**: Path traversal protection, file type validation, size limits. **Differentiator**: Only MCP server with web UI for document ingestion and chunking visualization. **Related Docs**: [Examples](09-Examples.md), [Integration Guide](03-Integration-Guide.md) --- ## Advanced Intelligence ### 14. Natural Memory Triggers v7.1.3 (Latest) **What it does**: Automatically detects when you need memory context without explicit commands. **Key Capabilities**: - **85%+ trigger accuracy** - Semantic pattern detection - **Multi-tier processing** - 50ms instant → 150ms fast → 500ms intensive - **CLI management system** - Real-time configuration without restarts - **Git-aware context** - Integrates recent commits, branch names, CHANGELOG - **Zero-restart installation** - `python install_hooks.py --natural-triggers` **Performance Profiles**: - `speed_focused`: <100ms, instant tier only (minimal memory awareness) - `balanced`: <200ms, instant + fast tiers (recommended for development) - `memory_aware`: <500ms, all tiers (maximum context for complex work) - `adaptive`: Auto-adjusts based on usage patterns and feedback **Installation**: ```bash cd claude-hooks python install_hooks.py --natural-triggers # Verify installation node ~/.claude/hooks/memory-mode-controller.js status ``` **Configuration** (`~/.claude/hooks/config.json`): ```json { "naturalTriggers": { "enabled": true, "triggerThreshold": 0.6, "cooldownPeriod": 30000, "maxMemoriesPerTrigger": 5 } } ``` **Differentiator**: Industry-first proactive memory awareness system with 85%+ accuracy. **Related Docs**: [Memory Hooks Complete Guide](Memory-Hooks-Complete-Guide.md), [Natural Memory Triggers v7.1.0](Natural-Memory-Triggers-v7.1.0.md) --- ### 15. CLI Management System (v7.1.3) **What it does**: Real-time configuration without file edits or restarts. **Available Commands**: ```bash # System health and performance node ~/.claude/hooks/memory-mode-controller.js status # Switch performance profiles node ~/.claude/hooks/memory-mode-controller.js profile balanced # Adjust trigger sensitivity (0.0 - 1.0) node ~/.claude/hooks/memory-mode-controller.js sensitivity 0.6 # View detailed metrics node ~/.claude/hooks/memory-mode-controller.js metrics # Comprehensive health check node ~/.claude/hooks/memory-mode-controller.js health # Test trigger detection node ~/.claude/hooks/memory-mode-controller.js test "What did we decide about auth?" ``` **Real-Time Tuning**: - Adjust trigger frequency without restarts - Monitor performance impact - Test pattern matching before enabling **Differentiator**: Industry-first real-time memory system tuning CLI. **Related Docs**: [Memory Hooks Complete Guide](Memory-Hooks-Complete-Guide.md) --- ### 16. Git-Aware Context Analysis (v7.1.3) **What it does**: Automatically extracts context from recent commits, branch names, and CHANGELOG. **Extracted Context**: - **Recent commits**: Keywords, files changed, commit messages - **Branch names**: Feature names, issue numbers - **CHANGELOG entries**: Recent releases, breaking changes - **Repository stats**: Activity patterns, contributor info **Automatic Injection** (Session Start Hook): ``` 🧠 Memory Hook → Initializing session awareness... 📂 Project Detector → Analyzing mcp-memory-service 📊 Git Context → 10 commits, 3 changelog entries 🔑 Keywords → docs, memory, version, v7.1.0, v7.1.3 ``` **Recent Improvements** (v8.22.0): - Fixed memory age calculation (now shows "today", "2d ago" correctly) - Increased timeouts (15s/20s to prevent DNS failures) - ANSI-aware tree formatting (no more broken lines) **Differentiator**: Only MCP server with automatic git repository analysis for context enrichment. **Related Docs**: [Memory Hooks Complete Guide](Memory-Hooks-Complete-Guide.md) --- ### 17. Memory Quality System (v8.45.0+) **What it does**: AI-driven automatic quality scoring with local-first design for zero-cost, privacy-preserving memory evaluation. **Multi-Tier Architecture**: - **Tier 1 (Primary)**: Local SLM via ONNX (ms-marco-MiniLM-L-6-v2, 23MB) - Cost: **$0** (runs locally, CPU/GPU) - Latency: 50-100ms (CPU), 10-20ms (GPU with CUDA/MPS/DirectML) - Privacy: ✅ Full (no external API calls) - Offline: ✅ Works without internet - **Tier 2-3 (Optional)**: Groq/Gemini APIs (user opt-in only) - **Tier 4 (Fallback)**: Implicit signals (access patterns, retrieval frequency) **Key Capabilities**: - **Automatic Quality Scoring**: Evaluates every retrieved memory (0.0-1.0 score) - **Quality-Boosted Search**: Reranks results: `0.7 × semantic + 0.3 × quality` - **Quality-Based Forgetting**: High quality (≥0.7) preserved 365 days, low (<0.5) archived 30-90 days - **Dashboard Integration**: Quality badges on memory cards, analytics distribution charts **Configuration**: ```bash # Quality System (Local-First Defaults) export MCP_QUALITY_SYSTEM_ENABLED=true # Default: enabled export MCP_QUALITY_AI_PROVIDER=local # local|groq|gemini|auto|none export MCP_QUALITY_LOCAL_MODEL=ms-marco-MiniLM-L-6-v2 export MCP_QUALITY_LOCAL_DEVICE=auto # auto|cpu|cuda|mps|directml # Quality-Boosted Search (Opt-In) export MCP_QUALITY_BOOST_ENABLED=false # Default: disabled (opt-in) export MCP_QUALITY_BOOST_WEIGHT=0.3 # 0.3 = 30% quality, 70% semantic ``` **MCP Tools**: - `memory_quality(action="rate", content_hash=..., rating=..., feedback=...)` - Manual quality rating (-1/0/1) - `memory_quality(action="get", content_hash=...)` - Retrieve quality metrics - `memory_quality(action="analyze", min_quality=..., max_quality=...)` - System-wide analytics - `memory_search(query, mode="hybrid", quality_boost=True, quality_weight=...)` - Quality-boosted search **Success Metrics**: - ✅ **>40% improvement** in retrieval precision (50% → 70%+ useful) - ✅ **>95% local SLM usage** (Tier 1 success rate) - ✅ **<100ms search latency** with quality boost - ✅ **$0 monthly cost** (local SLM default) **Differentiator**: First and only MCP server with AI-powered quality scoring using local SLM (zero external API calls, full privacy). **Related Docs**: [Memory Quality System Guide](14-Memory-Quality-System-Guide.md), [Web Dashboard Guide](Web-Dashboard-Guide.md) --- ### 18. Context-Provider Integration (v8.0.0+) **What it does**: Rule-based context management that complements Natural Memory Triggers. **Available Contexts**: - **Python MCP Memory Service** - FastAPI, MCP protocol, storage backends - **Release Workflow** - PR review, version management, CHANGELOG, issue tracking - **Custom contexts** - Create via MCP tools **Auto-Store Patterns**: - Technical: `MCP protocol`, `storage backend switch`, `embedding cache` - Configuration: `cloudflare configuration`, `hybrid backend setup` - Release: `merged PR`, `created tag`, `CHANGELOG conflict` - Issues: `fixes #`, `closes #`, `resolves #`, `created issue` **Auto-Retrieve Patterns**: - Troubleshooting: `cloudflare backend error`, `MCP client connection` - Setup: `backend configuration`, `environment setup` - Development: `MCP handler example`, `API endpoint pattern` - Issues: `review open issues`, `what issues fixed`, `can we close` **MCP Tools**: ```bash # List available contexts mcp context list # Check session initialization status mcp context status # Get optimization suggestions mcp context optimize ``` **Differentiator**: Only MCP server with dual intelligence (AI triggers + rule-based patterns). **Related Docs**: [Context Provider Workflow Automation](Context-Provider-Workflow-Automation.md) --- ## Performance Features ### 19. Code Execution Interface API (v8.19.0) **What it does**: Revolutionary token efficiency for MCP operations. **Token Reduction**: - **Session hooks**: 75% reduction (3,600 → 900 tokens) - **Search operations**: 85% reduction (2,625 → 385 tokens) - **Store operations**: 90% reduction (150 → 15 tokens) **Execution Performance**: - **Cold start**: 61.1ms (target <100ms) ✅ - **Warm calls**: 1.3ms avg (target <10ms) ✅ - **Memory overhead**: <10MB **Annual Savings** (1000 users): - 15.9B tokens saved - $2,382/year cost reduction - 96.7% faster context setup (15min → 30sec) **Technical Implementation**: ```python # Traditional MCP tool response (verbose JSON) { "content": [{"type": "text", "text": "Stored: ...long content..."}] } # Code Execution API (concise) { "isError": false } ``` **Differentiator**: Only MCP server with native Code Execution Interface API support. **Related Docs**: [Performance Optimization](05-Performance-Optimization.md) --- ### 20. Analytics Dashboard Optimization (v8.18.0) **What it does**: 90% performance improvement for dashboard analytics. **Technical Improvement**: - **Before**: N individual SQL queries (one per statistic) - **After**: Single optimized SQL query with aggregations - **Impact**: Dashboard loads significantly faster with large datasets **Validated Performance** (2,222 memories): - Analytics page load: <2s - Memory growth chart: Real-time rendering - Type distribution: Instant visualization **Differentiator**: Industry-leading dashboard performance for large memory sets. **Related Docs**: [Performance Optimization](05-Performance-Optimization.md) --- ### 21. Global Caching Architecture (v8.19.0) **What it does**: Intelligent caching reduces redundant operations. **Cached Components**: - **Embedding cache**: Reuse embeddings for duplicate queries - **Health check cache**: Reduce backend polling frequency - **Session context**: Persist git analysis across requests **Performance Impact**: - Warm search: 1.3ms (vs 500ms cold) - Reduced API calls to embedding services - Lower memory churn **Related Docs**: [Performance Optimization](05-Performance-Optimization.md) --- ### 22. Incremental Processing (v8.19.0) **What it does**: Stream results as they become available. **Use Cases**: - Document chunking with progress updates - Large search results with pagination - Real-time analytics updates via SSE **Performance**: - First result: <50ms (vs waiting for complete set) - User-perceived latency: Significantly reduced - Better responsiveness for large operations **Related Docs**: [Integration Guide](03-Integration-Guide.md) --- ## Developer Tools ### 23. Comprehensive Validation Scripts (120+ utilities) **What it does**: Automated diagnostics and repair tools across 5 categories. **Categories**: **1. Validation** (8 scripts): - `validate_configuration_complete.py` - Comprehensive config validation - `diagnose_backend_config.py` - Cloudflare diagnostics - `validate_environment.py` - Environment variable checks **2. Maintenance** (6 scripts): - `find_all_duplicates.py` - Duplicate detection - `consolidate_memory_types.py` - Type taxonomy enforcement - `cleanup_encoding_errors.py` - UTF-8 validation and repair **3. Backup** (4 scripts): - `backup_memories.py` - Timestamped backups with validation - `create_distributable_backup.py` - Portable JSON export **4. Migration** (6 scripts): - `migrate_backend.py` - Cross-backend data migration - `fix_timestamps.py` - Timestamp normalization - `migrate_schema.py` - Schema version upgrades **5. Testing** (5 scripts): - `test_all_backends.py` - Complete system validation - `test_api_endpoints.py` - REST API testing - `benchmark_performance.py` - Performance profiling **Usage Example**: ```bash # Comprehensive validation python scripts/validation/validate_configuration_complete.py # Backend diagnostics python scripts/validation/diagnose_backend_config.py # Find and remove duplicates python scripts/maintenance/find_all_duplicates.py ``` **Differentiator**: Most comprehensive tooling ecosystem of any MCP server (120+ utilities). **Related Docs**: [scripts/README.md](https://github.com/doobidoo/mcp-memory-service/blob/main/scripts/README.md), [TROUBLESHOOTING](07-TROUBLESHOOTING.md) --- ### 24. Memory Type Taxonomy System (v8.16.0) **What it does**: Standardized 24 core types prevent fragmentation. **Core Types** (24 total): - **Content**: note, reference, document, guide - **Activity**: session, implementation, analysis, troubleshooting, test - **Artifact**: fix, feature, release, deployment - **Progress**: milestone, status - **Infrastructure**: configuration, infrastructure, process, security, architecture **Consolidation Tool**: ```bash # Preview consolidation (dry-run) python scripts/maintenance/consolidate_memory_types.py --dry-run # Execute consolidation python scripts/maintenance/consolidate_memory_types.py # Example result: 342 types → 128 types (63% reduction) ``` **Benefits**: - Consistent categorization across team - Better search and filtering - Reduced cognitive overhead **Differentiator**: Only MCP server with enforced memory type taxonomy and automated consolidation. **Related Docs**: [scripts/maintenance/memory-types.md](https://github.com/doobidoo/mcp-memory-service/blob/main/scripts/maintenance/memory-types.md) --- ### 25. REST API Endpoints (40+ endpoints) **What it does**: Complete HTTP API for all memory operations. **Categories**: **Memories**: - `GET /api/memories` - List all memories - `POST /api/memories` - Create memory - `GET /api/memories/{id}` - Get specific memory - `PUT /api/memories/{id}` - Update memory - `DELETE /api/memories/{id}` - Delete memory **Search**: - `POST /api/search` - Semantic search - `POST /api/search/by-tag` - Tag-based search - `POST /api/search/by-time` - Natural language time queries **Documents**: - `POST /api/documents/upload` - Upload document - `GET /api/documents/{id}` - Get document details - `GET /api/documents/{id}/chunks` - List chunks **Analytics**: - `GET /api/analytics/overview` - Summary statistics - `GET /api/analytics/growth` - Memory growth over time - `GET /api/analytics/types` - Type distribution **Health & OAuth**: - `GET /api/health` - Basic health check - `GET /api/health/detailed` - Comprehensive diagnostics - `GET /.well-known/oauth-authorization-server/mcp` - OAuth discovery **Events**: - `GET /api/events` - Server-Sent Events stream **Authentication**: ```bash # API Key (header) curl -H "X-API-Key: your-key" http://127.0.0.1:8888/api/memories # OAuth (JWT Bearer token) curl -H "Authorization: Bearer jwt-token" http://127.0.0.1:8888/api/memories ``` **Documentation**: Auto-generated Swagger/ReDoc at `/api/docs` and `/api/redoc` **Differentiator**: Most comprehensive REST API of any MCP server (40+ endpoints). **Related Docs**: [Integration Guide](03-Integration-Guide.md), [Examples](09-Examples.md) --- ### 26. mDNS Service Discovery (v2.1.0+) **What it does**: Zero-configuration networking for local network services. **Key Capabilities**: - Automatic service advertisement (`_mcp-memory._tcp.local.`) - Auto-discovery without manual configuration - HTTPS prioritization over HTTP - Service health validation before advertising **Configuration**: ```bash export MCP_MDNS_ENABLED=true export MCP_MDNS_SERVICE_NAME="MCP Memory Service" ``` **Use Case**: Teams on same network can auto-discover shared memory services without manual IP configuration. **Differentiator**: Only MCP server with mDNS service discovery support. **Related Docs**: [Advanced Configuration](04-Advanced-Configuration.md) --- ## Agent Integrations ### 27. GitHub Release Manager Agent (v8.17.0+) **What it does**: Complete release workflow automation with issue tracking. **Capabilities**: - **Version management**: Four-file procedure (`__init__.py` → `pyproject.toml` → `README.md` → `uv lock`) - **CHANGELOG management**: Format guidelines, conflict resolution - **Issue tracking**: Auto-detects "fixes #", suggests closures with smart comments - **Documentation updates**: CHANGELOG, Wiki, README - **Workflow verification**: Docker Publish, PyPI, HTTP-MCP Bridge **Usage**: ```bash # Proactive (auto-invoked on feature completion) # Manual invocation @agent github-release-manager "Check if we need a release" @agent github-release-manager "Create release for v8.20.0" ``` **Recent Success**: v8.20.1 (8 minutes from bug report → fix → release → user notification) **Differentiator**: Only MCP server with comprehensive release automation agent. **Related Docs**: [Agent Integrations Guide](11-Agent-Integrations-Guide.md), `.claude/agents/github-release-manager.md` --- ### 28. Groq Bridge Integration (v8.20.0) **What it does**: 10x faster LLM inference for code quality checks. **Performance Comparison**: - **Gemini CLI**: 2-3s (OAuth browser flow) - **Groq API**: 200-300ms (simple API key) - **Speedup**: ~10x faster **Supported Models**: - `llama-3.3-70b-versatile`: ~300ms (default, balanced) - `moonshotai/kimi-k2-instruct`: ~200ms, 256K context (best for coding) - `llama-3.1-8b-instant`: ~100ms (fast queries) **Use Cases**: - Pre-commit hooks (complexity, security checks) - Code quality analysis - PR automation (test generation, breaking change detection) **Setup**: ```bash export GROQ_API_KEY="your-groq-api-key" # Use in pre-commit hooks ./scripts/utils/groq "Complexity 1-10 per function: $(cat file.py)" # With specific model ./scripts/utils/groq "Security scan: $(cat file.py)" --model moonshotai/kimi-k2-instruct ``` **Differentiator**: Non-interactive API (no OAuth browser interruption during commits). **Related Docs**: [Agent Integrations Guide](11-Agent-Integrations-Guide.md), `docs/integrations/groq-bridge.md` --- ### 29. Gemini PR Automator Agent (v8.20.0) **What it does**: Eliminates manual "Fix → Comment → /gemini review → Wait" cycles. **Features**: - Automated review loops (saves 10-30 min/PR) - Quality gate checks (complexity, security, tests, breaking changes) - Test generation for new code - GraphQL integration for thread resolution **Usage**: ```bash # Full automated review (5 iterations, safe fixes) bash scripts/pr/auto_review.sh # Quality gate checks before review bash scripts/pr/quality_gate.sh # Generate tests for new code bash scripts/pr/generate_tests.sh # Breaking change detection bash scripts/pr/detect_breaking_changes.sh main ``` **Impact**: - Auto-resolve review threads when commits address feedback (saves 2+ min/PR) - 10-30 minute time savings per PR vs manual iteration **Differentiator**: Fully automated PR iteration with GraphQL thread resolution. **Related Docs**: [Agent Integrations Guide](11-Agent-Integrations-Guide.md), `.claude/agents/gemini-pr-automator.md` --- ### 30. Code Quality Guard Agent (v8.20.0) **What it does**: Fast automated code quality analysis. **Features**: - **Complexity scoring**: Blocks >8, warns >7 - **Security patterns**: SQL injection, XSS, command injection detection - **TODO prioritization**: Critical/High/Medium/Low categorization - **Pre-commit hooks**: Automatic quality gates **LLM Priority** (v8.20.0): 1. **Groq API** (Primary) - 200-300ms, no OAuth 2. **Gemini CLI** (Fallback) - 2-3s, OAuth browser flow 3. **Skip checks** (Graceful) - If neither available **Pre-commit Hook Setup**: ```bash # Install hook ln -s ../../scripts/hooks/pre-commit .git/hooks/pre-commit # Configure LLM (Groq recommended) export GROQ_API_KEY="your-groq-api-key" # Falls back to Gemini CLI if Groq unavailable ``` **Usage**: ```bash # Complexity check (Groq - fast) ./scripts/utils/groq "Complexity 1-10 per function: $(cat file.py)" # Security scan gemini "Security check (SQL injection, XSS): $(cat file.py)" # TODO scan bash scripts/maintenance/scan_todos.sh ``` **Differentiator**: Dual-LLM support with intelligent fallback for uninterrupted workflows. **Related Docs**: [Agent Integrations Guide](11-Agent-Integrations-Guide.md), `.claude/agents/code-quality-guard.md` --- ### 31. Amp CLI Bridge (v8.17.0+) **What it does**: Leverage Amp CLI for research without consuming Claude Code credits. **Architecture**: File-based workflow 1. Claude creates prompt in `.claude/amp/prompts/pending/{uuid}.json` 2. User runs `amp @.claude/amp/prompts/pending/{uuid}.json` 3. Amp writes response to `.claude/amp/responses/{uuid}.json` 4. Claude reads response and continues **Use Cases**: - Web research (fetch documentation, Stack Overflow) - Codebase analysis (understand patterns, best practices) - Documentation generation (API docs, guides) - Best practices research **Workflow**: ```bash # Claude: "I'll create a prompt for Amp to research OAuth 2.1 best practices" # Claude creates: .claude/amp/prompts/pending/abc123.json # User runs: amp @.claude/amp/prompts/pending/abc123.json # Claude: "Thanks! I'll read the response and continue" ``` **Differentiator**: Semi-automated credit-conserving workflow for research tasks. **Related Docs**: [Agent Integrations Guide](11-Agent-Integrations-Guide.md), `docs/amp-cli-bridge.md` --- ## Security & Reliability ### 32. Security Hardening (v7.0.0+) **What it does**: Enterprise-grade security for production deployments. **Security Features**: - **Path traversal protection** (document ingestion) - **XSS prevention** (input validation) - **JWT authentication** (scope validation, expiration) - **HTTPS/SSL support** (auto-generated certificates) - **API key authentication** (backward compatible) - **Rate limiting** (OAuth endpoints) **Compliance**: - OAuth 2.1 (RFC 8252) - Dynamic Client Registration (RFC 7591) - Authorization Server Metadata (RFC 8414) **Configuration**: ```bash # HTTPS with auto-generated certificates export MCP_HTTPS_ENABLED=true export MCP_HTTPS_CERT_PATH="/path/to/cert.pem" export MCP_HTTPS_KEY_PATH="/path/to/key.pem" # API key authentication export MCP_API_KEY="$(openssl rand -base64 32)" ``` **Differentiator**: Only MCP server with full OAuth 2.1 compliance and enterprise security features. **Related Docs**: [OAuth 2.1 Setup Guide](OAuth-2.1-Setup-Guide.md), [Advanced Configuration](04-Advanced-Configuration.md) --- ### 33. Comprehensive Error Handling (v8.9.0+) **What it does**: Graceful degradation and detailed diagnostics. **Features**: - **Automatic fallback**: Hybrid → SQLite if Cloudflare unavailable - **Retry logic**: Exponential backoff with jitter - **Health monitoring**: Continuous backend validation - **Database lock detection**: Auto-recovery with pragmas - **Disk space verification**: Pre-operation validation **Error Recovery**: ```python # Example: Cloudflare offline, automatic fallback INFO: Cloudflare sync failed (network error) INFO: Falling back to SQLite-only mode INFO: Will retry Cloudflare in 5 minutes ``` **Monitoring**: ```bash # Health check curl http://127.0.0.1:8888/api/health/detailed # Response includes: # - Backend status (connected/degraded/offline) # - Last successful sync timestamp # - Error count and recent errors # - Disk space available ``` **Differentiator**: Most robust error handling and failover of any MCP server. **Related Docs**: [TROUBLESHOOTING](07-TROUBLESHOOTING.md) --- ### 34. Backup & Recovery System (v4.0.0+) **What it does**: Automated backups with validation and restore capabilities. **Features**: - **Timestamped automatic backups** before major operations - **Transaction safety** (atomic with rollback) - **Backup integrity validation** (checksums, schema verification) - **Distributable export format** (portable JSON) - **Cross-backend migration** support **Backup Scripts**: ```bash # Create timestamped backup python scripts/backup/backup_memories.py # Create distributable backup (JSON) python scripts/backup/create_distributable_backup.py # Restore from backup python scripts/backup/restore_from_backup.py backup.json # Migrate between backends python scripts/migration/migrate_backend.py --source cloudflare --dest hybrid ``` **Automatic Backups**: - Before schema migrations - Before bulk deletions - Before backend switches - Configurable retention policy **Differentiator**: Most comprehensive backup and recovery system of any MCP server. **Related Docs**: [scripts/README.md](https://github.com/doobidoo/mcp-memory-service/blob/main/scripts/README.md), [Advanced Configuration](04-Advanced-Configuration.md) --- ## Production Metrics ### Real-World Validation **Scale**: - 1,700+ memories actively used in production - 2,222 memories tested in dashboard analytics - Zero database lock errors (after v8.9.0) - Zero data loss incidents **Development Velocity**: - 173 releases over 10 months (~17 releases/month) - 1,536 commits across 10 months (~5 commits/day) - 96% issue closure rate (94 of 98 issues) - Active development: 200 days (65% of 10-month period) **Performance**: - 5ms local read performance (SQLite-vec) - <500ms semantic search (local & HTTP) - 25ms dashboard page load - 100% knowledge retention across sessions - 65% token reduction (OAuth vs traditional MCP) --- ## Related Resources - [Home](Home.md) - Main wiki page - [Installation Guide](01-Installation-Guide.md) - Getting started - [Integration Guide](03-Integration-Guide.md) - Client setup - [Advanced Configuration](04-Advanced-Configuration.md) - Production deployment - [Agent Integrations Guide](11-Agent-Integrations-Guide.md) - Workflow automation - [TROUBLESHOOTING](07-TROUBLESHOOTING.md) - Common issues - [GitHub Repository](https://github.com/doobidoo/mcp-memory-service) ---

📚 Documentation

Home
Installation
Integration
Troubleshooting

🚀 Features

All 33 Features
Memory Hooks
Web Dashboard
OAuth 2.1

🤖 Automation

Agent Guide
Cross-Repo Setup
Context Provider

🌟 Community

GitHub
Discussions
Issues
Contribute
--- **MCP Memory Service** • Zero database locks • 5ms reads • 85% accurate memory triggers *Maintained by the community • Licensed under [MIT](https://github.com/doobidoo/mcp-memory-service/blob/main/LICENSE)*
--- ## 📚 Documentation | 🚀 Features | 🤖 Automation | 🌟 Community **Documentation**: [Home](./Home) • [Installation](./01-Installation-Guide) • [Integration](./03-Integration-Guide) • [Troubleshooting](./07-TROUBLESHOOTING) **Features**: [All 34 Features](./10-Complete-Feature-List) • [Memory Hooks](./Memory-Hooks-Complete-Guide) • [Web Dashboard](./Web-Dashboard-Guide) • [OAuth 2.1](./OAuth-2.1-Setup-Guide) **Automation**: [Agent Guide](./11-Agent-Integrations-Guide) • [Cross-Repo Setup](./12-Using-Agents-in-Other-Repositories) • [Context Provider](./Context-Provider-Workflow-Automation) **Community**: [GitHub](https://github.com/doobidoo/mcp-memory-service) • [Discussions](https://github.com/doobidoo/mcp-memory-service/discussions) • [Issues](https://github.com/doobidoo/mcp-memory-service/issues) • [Contribute](https://github.com/doobidoo/mcp-memory-service/blob/main/CONTRIBUTING.md) --- **MCP Memory Service** • Zero database locks • 5ms reads • 85% accurate memory triggers • [MIT License](https://github.com/doobidoo/mcp-memory-service/blob/main/LICENSE)