MCP Memory Enhanced

An enhanced fork of the official MCP Memory Server with SQLite backend support for improved performance and scalability. Now at v1.0.0 - Production Ready! 🚀

🚀 Features

• Dual Storage Backend: Choose between JSON (original) and SQLite storage
• Performance Optimized: SQLite backend for faster entity creation and searches
• Production-Ready Docker Support: Multi-stage builds, health checks, and UnRAID compatibility
• Backward Compatible: 100% compatible with the original MCP protocol
• Migration Tools: Seamlessly migrate from JSON to SQLite storage
• Comprehensive Benchmarking: Built-in performance validation and monitoring

📊 Performance Comparison

<<<<<<< HEAD Based on benchmarks with 10,000 entities:

Note: Performance varies based on hardware and dataset characteristics. SQLite excels at indexed searches and concurrent access, while JSON provides simpler deployment and smaller file sizes for this dataset size.

Based on comprehensive benchmarks with datasets from 10K to 500K entities (validated 2025-08-08):

*Storage size validation pending; preliminary tests show 30-40% reduction

Note: Performance improvements scale with dataset size. Larger datasets show more dramatic improvements, with 500K entities showing 119x faster creation and consistent 90%+ memory reduction. Benchmarks run on standard hardware with Node.js v22.

dev/v1.0.2

🐳 Quick Start with Docker

docker run -d \
  --name mcp-memory-enhanced \
  -p 6970:6970 \
  -v /path/to/data:/data \
  -e STORAGE_TYPE=sqlite \
  ghcr.io/jamesprial/mcp-memory-enhanced:latest

📦 Installation

From npm (via GitHub)

# Latest version
npm install github:JamesPrial/mcp-memory-enhanced

# Specific version
npm install github:JamesPrial/mcp-memory-enhanced#v1.0.0

From Source

git clone https://github.com/JamesPrial/mcp-memory-enhanced.git
cd mcp-memory-enhanced
npm install
npm run build

Using Docker Compose

docker-compose up -d

🔧 Configuration

Environment Variables

MCP Configuration

Add to your MCP client settings:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/mcp-memory-enhanced/dist/index.js"],
      "env": {
        "STORAGE_TYPE": "sqlite",
        "STORAGE_PATH": "/path/to/data"
      }
    }
  }
}

🔄 Migration from JSON to SQLite

# Using the migration tool
npm run migrate /path/to/knowledge-graph.jsonl

Or with Docker:

docker run --rm \
  -v /path/to/json-data:/source \
  -v /path/to/sqlite-data:/data \
  ghcr.io/jamesprial/mcp-memory-enhanced:latest \
  node dist/migrate.js /source/knowledge-graph.jsonl

🏥 Health Check (Docker only)

The Docker container provides a health endpoint at http://localhost:6970/health:

{
  "status": "healthy",
  "timestamp": "2025-08-05T12:00:00.000Z",
  "storage": {
    "type": "sqlite",
    "stats": {
      "entityCount": 1000,
      "relationCount": 500,
      "observationCount": 2000,
      "storageSize": 1048576
    }
  }
}

🚀 UnRAID Deployment

1. Download the UnRAID template
2. In UnRAID web UI: Docker → Add Container → Template
3. Select the template file and configure as needed

🛠️ Development

Running Tests

npm test

Building Docker Image

docker build -f Dockerfile.standalone -t mcp-memory-enhanced .

Running Locally

STORAGE_TYPE=sqlite npm start

📈 Architecture

The Enhanced MCP Memory Server uses a clean storage abstraction layer:

┌─────────────────┐
│   MCP Client    │
└────────┬────────┘
         │ stdio
┌────────▼────────┐
│   MCP Server    │
│   (index.ts)    │
└────────┬────────┘
         │
┌────────▼────────┐
│ KnowledgeGraph  │
│    Manager      │
└────────┬────────┘
         │
┌────────▼────────┐
│ IStorageBackend │
└────────┬────────┘
         │
    ┌────┴────┐
    │         │
┌───▼───┐ ┌──▼────┐
│ JSON  │ │SQLite │
└───────┘ └───────┘

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Original MCP Memory Server by Anthropic
• Built with the MCP TypeScript SDK
• Powered by better-sqlite3

📊 Status

• Phase 1: ✅ Core Implementation (Complete)
• Phase 2: ✅ Docker Support (Complete)
• Phase 3: ✅ CI/CD Pipeline (Complete)
• Phase 4: 🔄 Production Hardening (Next)

🤖 Enhanced for production use with ❤️ by @JamesPrial