JamesPrial/mcp-memory-enhanced

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
• 3-10x Performance Improvement: SQLite backend offers significant speed gains
• 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

📊 Performance Comparison

Based on benchmarks with 10,000+ entities:

🐳 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
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 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