Skip to content
Henry edited this page Aug 22, 2025 · 20 revisions

MCP Memory Service Wiki

Welcome to the MCP Memory Service Wiki! This is your comprehensive guide to leveraging AI-powered memory management in your daily workflows.

🧠 What is MCP Memory Service?

MCP Memory Service is a powerful tool that extends AI assistants with persistent, searchable memory capabilities. It allows you to:

  • Store important information, decisions, and learnings
  • Retrieve relevant context from past conversations
  • Build a personal knowledge base that grows with you
  • Organize information with tags and natural language search

🚀 Quick Start

Basic Commands

# Store a memory
\"Remember that our deployment process uses GitHub Actions with staging first\"

# Retrieve memories
\"What do you know about our deployment process?\"

# Search by time
\"What did we discuss yesterday about the API changes?\"

# Search by tags
\"Show me all memories tagged with 'python' and 'debugging'\"

📅 Day-to-Day Usage

1. Project Management

Morning: \"Recall what I was working on yesterday\"
During work: \"Remember that the API endpoint /users/profile has a rate limit issue\"
End of day: \"Summarize today's progress and key decisions\"

2. Learning & Development

\"Remember this solution for handling async operations in Python\"
\"Store this regex pattern for parsing log files: [pattern]\"
\"What debugging techniques have I used for memory leaks?\"

3. Meeting Notes

\"Store meeting notes: Product roadmap discussion - Q2 priorities include...\"
\"What were the action items from last week's planning meeting?\"
\"Remember John is the point person for the authentication service\"

4. Personal Workflows

\"Remember my preferred VSCode settings for Python development\"
\"Store this bash alias for quick database connections\"
\"What's my usual process for reviewing PRs?\"

🔄 Periodic & Automatic Memorization

Setting Up Recurring Reviews

Create periodic memory maintenance routines:

Weekly Review Prompt:

\"Every Friday, run memory maintenance:
1. Review and tag memories from this week
2. Consolidate related memories
3. Archive completed project memories
4. Generate a weekly summary\"

Daily Standup Helper:

\"Each morning:
1. Recall yesterday's tasks and progress
2. Check for blocked items
3. Review today's priorities
4. Store the daily plan\"

Automatic Memorization Patterns

Project Context:

\"For all conversations about [project-name]:
- Automatically store technical decisions
- Remember configuration changes
- Track dependencies and versions
- Note team member responsibilities\"

Learning Capture:

\"When I say 'TIL' (Today I Learned):
- Store the learning with tag 'til'
- Add relevant technology tags
- Include the date
- Link to related memories\"

Error Solutions:

\"When we solve an error or bug:
- Store the error message
- Remember the solution
- Tag with 'debugging' and the technology
- Include any relevant code snippets\"

🧠 Latest: v6.1.0 - Intelligent Context Updates (Phase 2)

🚀 REVOLUTIONARY UPDATE: Claude Code Memory Awareness

  • Phase 2 Complete: Dynamic memory loading during conversations with real-time topic detection
  • Conversation Intelligence: NLP engine analyzing topics, entities, intent, and code context
  • Cross-Session Intelligence: Conversation threading and progress continuity across sessions
  • 100% Test Coverage: Production-ready with comprehensive integration testing
  • <500ms Response Time: Lightning-fast context updates that don't interrupt your flow

🎯 Complete Claude Code Integration

Transform your development workflow with intelligent memory that:

  • Remembers your project context across all coding sessions
  • Learns from conversations and provides dynamic context updates
  • Connects related discussions across different sessions
  • Provides perfect timing for relevant information injection

🆕 New Guides & Features

📚 What's in This Wiki

🌟 Featured Guides

  1. 🧠 Claude Code Memory Awareness Guide - MUST READ! Complete workflow guide for intelligent development with memory-aware coding
  2. ⚡ Claude Code Quick Reference - START HERE! Essential commands, setup, and troubleshooting for immediate productivity
  3. 🔍 Debugging Case Study - Real-world debugging journey from production failure to major improvements
  4. 🧠 CLAUDE.md Memory Pattern - Revolutionary context management for AI development (65% token reduction!)

Core Guides

  1. Memory Cleanup Example - Learn how to maintain a clean, organized memory database
  2. Tag System Migration and Management - Comprehensive guide to organizing memories with tags
  3. Building a React Dashboard - Create a visual interface for your memories
  4. Performance Optimization - Make your memory service lightning fast

Technical Deep Dives

  1. 🔧 Troubleshooting Guide - NEW! Comprehensive solutions for deployment, database, and service issues
  2. Timestamp Precision Fix - How natural language time queries work
  3. Debugging MCP Protocol - Troubleshooting guide for common issues
  4. Query Time Tracking - Implementation case study

Advanced Features

  1. Memory Re-tagging System - Three-phase approach to organization
  2. Integration Patterns - Connect with other tools and services
  3. Best Practices - Tips for effective memory management
  4. Ngrok Connectivity Guide - Secure external access for remote clients

💡 Use Case Examples

Software Development

  • Store code snippets and solutions
  • Track architectural decisions
  • Remember debugging sessions
  • Document API changes and migrations

Research & Learning

  • Capture key insights from articles
  • Build a personal knowledge base
  • Track learning progress
  • Connect related concepts

Team Collaboration

  • Share team knowledge
  • Document decisions and rationale
  • Track project evolution
  • Maintain institutional memory

Personal Productivity

  • Remember preferences and settings
  • Track habits and routines
  • Store quick references
  • Build personal documentation

🐳 Docker Setup (Now Super Simple!)

Thanks to community feedback from Joe Esposito, we completely simplified Docker in v5.0.4!

Choose Your Mode:

🤖 MCP Mode (for Claude Desktop, VS Code):

docker-compose up -d

🌐 HTTP Mode (for REST API, Web Dashboard):

docker-compose -f docker-compose.http.yml up -d
curl http://localhost:8000/api/health  # It just works!

That's it! No more confusion about which of 4 files to use.

What Changed?

  • ✅ Fixed missing run_server.py
  • ✅ Corrected Python paths
  • ✅ Pre-download models (no more runtime failures)
  • ✅ Smart unified entrypoint
  • ✅ 60% complexity reduction

Full Docker Story

🙏 Community Heroes

Joe Esposito discovered critical Docker issues and helped us completely overhaul the setup. His feedback led to the v5.0.4 Docker revolution - from 4 confusing configs to 2 crystal-clear options!

"Thanks for your quick reply Claude, lol... The good news is that all the dashboards are working now!" - Joe

This is exactly the kind of real-world feedback that makes MCP Memory Service better for everyone.

📈 Real-World Impact

Claude Code Memory Awareness (v6.1.0) in Production:

  • 100% test pass rate (15/15 comprehensive integration tests)
  • <500ms response time for dynamic context updates
  • Conversation intelligence with 15+ technical topic categories
  • Cross-session threading connecting related discussions over time
  • Zero cognitive load context updates during active coding

CLAUDE.md Memory Pattern Results:

  • 750+ memories stored and actively used
  • 65% token reduction in Claude Code sessions
  • 96.7% faster context setup (15min → 30sec)
  • 100% knowledge retention across sessions

Docker Platform Stability:

  • 60% less complexity (4 configs → 2)
  • 73% faster startup with pre-downloaded models
  • Zero confusion about deployment modes

Real metrics from real usage in production environments!

🛠️ Advanced Workflows

Memory Chains

Link related memories for context:

\"Create a memory chain for 'Project X Migration':
- Initial planning decisions
- Technical challenges encountered
- Solutions implemented
- Lessons learned\"

Contextual Triggers

Set up automatic memory retrieval:

\"When discussing AWS services, automatically recall:
- Our AWS configuration standards
- Common troubleshooting steps
- Cost optimization strategies\"

Memory Templates

Create reusable formats:

\"Bug Report Template:
- Error message
- Steps to reproduce
- Environment details
- Solution applied
- Prevention measures\"

🤝 Contributing to This Wiki

We welcome contributions from the community! Here's how you can help:

For Users

  • Share Your Workflows: Document how you use the memory service in your daily work
  • Use Case Examples: Add real-world examples of problems solved
  • Tips & Tricks: Share productivity hacks and best practices
  • Integration Guides: Document how you've connected the memory service with other tools

For Developers

  • Technical Guides: Write about implementation details and optimizations
  • Troubleshooting: Document issues you've encountered and solutions
  • Feature Tutorials: Create guides for new features you've built
  • Code Examples: Share useful scripts and utilities

Contribution Guidelines

  1. Be Practical: Focus on real-world usage and examples
  2. Include Code: Provide runnable examples where possible
  3. Document Results: Show before/after states and performance metrics
  4. Stay Organized: Follow the existing structure and naming conventions
  5. Test Everything: Ensure your examples work as described

How to Contribute

  1. Fork the repository
  2. Create your wiki page following our structure
  3. Include a clear table of contents
  4. Add your page to the relevant section in this home page
  5. Submit a pull request with a description of your addition

Ideas for Contributions

  • Integration with popular development tools
  • Domain-specific memory templates (DevOps, Data Science, etc.)
  • Automation scripts and workflows
  • Performance optimization techniques
  • Multi-user collaboration patterns
  • Mobile and cross-platform usage guides

🔮 Future Developments

Stay tuned for upcoming features:

  • Visual memory mapping
  • Advanced analytics and insights
  • Team collaboration features
  • API integrations
  • Mobile applications
  • Voice interaction capabilities

📞 Getting Help


Remember: The MCP Memory Service is more than a tool—it's your personal knowledge companion that grows smarter with every interaction. Start small, be consistent, and watch your digital memory become an invaluable asset in your daily work.

Happy memorizing! 🎉

Clone this wiki locally