Skip to content
Henry edited this page Sep 27, 2025 · 17 revisions

MCP Memory Service Wiki

Transform your AI interactions with persistent, searchable memory.

MCP Memory Service is a powerful Model Context Protocol server that gives AI assistants like Claude perfect memory of your conversations, decisions, and development work. Build a personal knowledge base that grows smarter over time.


🚀 Quick Start

New to MCP Memory Service? Get up and running in minutes:

1. Install & Setup

# Clone and install
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service
python install.py

# Start the service
uv run memory server

2. Basic Usage

# Store important information
"Remember that we use JWT tokens with 24-hour expiration for authentication"

# Search your memories
"What did we decide about the database schema yesterday?"

# Recall by time
"Show me what we worked on last week"

3. Claude Code Integration

# Install Natural Memory Triggers v7.1.0 (Latest)
cd claude-hooks
cp config.template.json config.json
# Edit config.json with your settings
node test-natural-triggers.js

# Manage performance profiles
node memory-mode-controller.js status
node memory-mode-controller.js profile balanced

✅ Ready! Claude Code now has intelligent memory awareness with automatic trigger detection.


📚 Documentation

Core Guides

Essential guides to get you productive quickly:

Guide Description
Installation Guide Complete setup for all platforms and backends
Platform Setup Guide Windows, macOS, Linux optimization
Integration Guide Claude Desktop, Claude Code, VS Code + 13 tools
Claude Code Commands & Hooks Complete guide to commands and automatic memory hooks

Advanced Topics

For power users and complex deployments:

Guide Description
Advanced Configuration Integration patterns, best practices, workflows
Performance Optimization Speed up queries, optimize resources, scaling
Development Reference Claude Code hooks, API reference, debugging

Help & Reference

When you need answers:

Resource Description
Troubleshooting Common issues and solutions
FAQ Frequently asked questions
Examples Practical code examples and workflows

🎯 Common Use Cases

For Developers

  • Project Context: Never lose track of architectural decisions
  • Bug Tracking: Remember solutions to similar problems
  • Code Reviews: Build institutional knowledge
  • Learning: Track new technologies and patterns

For Teams

  • Knowledge Sharing: Distribute expertise across team members
  • Decision History: Maintain context for future team members
  • Best Practices: Evolve coding standards organically
  • Onboarding: Help new members understand project history

For AI Interactions

  • Intelligent Memory Awareness: Automatic detection of memory-seeking patterns with 85%+ accuracy
  • Context-Aware Assistance: Multi-tier semantic analysis provides relevant context in <50ms
  • Adaptive Learning: System learns your preferences and optimizes trigger sensitivity
  • Git-Integrated Context: Repository history enhances memory relevance and project understanding

🏗️ Architecture Overview

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Clients    │    │  MCP Memory     │    │  Storage        │
│                 │    │  Service        │    │  Backends       │
├─────────────────┤    ├─────────────────┤    ├─────────────────┤
│ Claude Desktop  │◄──►│ MCP Protocol    │◄──►│ Hybrid (Rec)    │
│ Claude Code     │    │ HTTP/HTTPS API  │    │ SQLite-vec      │
│ VS Code         │    │ OAuth 2.1 Auth  │    │ ChromaDB        │
│ Custom Apps     │    │ Memory Manager  │    │ Cloudflare      │
│                 │    │ Search Engine   │    │ Custom Backend  │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Key Features:

  • 🧠 Intelligent Memory Triggers: Automatic pattern detection with 85%+ accuracy
  • Multi-Tier Performance: 50ms instant → 150ms fast → 500ms intensive processing
  • 🎮 CLI Management: Real-time configuration and performance monitoring
  • 🏷️ Git-Aware Context: Repository integration for enhanced relevance
  • 🔐 Enterprise Security: OAuth 2.1 + API keys + encryption
  • 🔌 Extensible: MCP protocol + REST APIs for any integration
  • 🚀 Team Collaboration: Claude Code HTTP transport with auto-discovery

🚦 Getting Help

Quick Support

Community & Support


📈 What's New

🧠 v7.1.0 - Natural Memory Triggers (Latest Release)

  • Intelligent Trigger Detection: Automatic memory retrieval using advanced semantic analysis
  • Multi-Tier Performance: 50ms instant → 150ms fast → 500ms intensive processing
  • CLI Management System: Real-time configuration with memory-mode-controller.js
  • Git-Aware Context: Repository integration for enhanced memory relevance
  • Adaptive Learning: 85%+ trigger accuracy with user preference optimization
  • Zero-Restart Installation: Dynamic hook loading during Claude Code sessions

🚀 v7.0.0 Major Release - OAuth 2.1 & Claude Code HTTP Transport

  • OAuth 2.1 Dynamic Client Registration: RFC 7591 & RFC 8414 compliant authentication
  • Claude Code HTTP Transport: Zero-configuration team collaboration support
  • Auto-Discovery Endpoints: Seamless OAuth client registration and authorization
  • Enterprise Security: JWT authentication with RS256 signing and scope validation
  • Backward Compatibility: All existing API key workflows continue unchanged

Recent Features (v6.4.0+)

  • Documentation Revolution: Streamlined guides, better navigation
  • Claude Code Memory Awareness: Automatic project context loading
  • Performance Improvements: Faster search, better resource usage
  • Hybrid Backend: SQLite speed with Cloudflare synchronization

Coming Soon

  • 🤖 Enhanced AI Insights: Advanced pattern recognition with Natural Memory Triggers data
  • 📊 Usage Analytics: Memory trigger effectiveness and optimization recommendations
  • 🔧 Team Memory Sharing: Collaborative memory awareness across development teams

Ready to supercharge your AI interactions? Pick a guide above and start building your intelligent memory system today!

Clone this wiki locally