MCP Memory Remote v1.0.5

Ultra-reliable MCP (Model Context Protocol) client for remote memory storage with offline support, health monitoring, and auto-recovery capabilities.

🚀 What's New in v1.0.5

Maximum Reliability Features

• 🔄 Offline Mode: Full functionality when server is unavailable
• 💓 Health Monitoring: Real-time connection health tracking
• 🔁 Auto-Retry Logic: Intelligent retry with exponential backoff
• 🔍 Self-Diagnostics: Built-in diagnose command for troubleshooting
• 📊 Enhanced Logging: Multi-level logging with file output support
• 🛡️ Failsafe Configuration: Multiple fallback configuration methods
• 📦 Offline Storage: Local cache for unsynced data
• 🔐 Security Hardening: Improved token validation and secure storage

🎯 Installation

Quick Start (Recommended)

npx @ai-solutions.ru/[email protected] setup

Manual Installation

npm install -g @ai-solutions.ru/[email protected]
mcp-memory-remote setup

Add to Claude Desktop

After setup, add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "memory-remote": {
      "command": "npx",
      "args": ["-y", "@ai-solutions.ru/[email protected]"]
    }
  }
}

🛠️ Commands

setup - Interactive Configuration

npx @ai-solutions.ru/mcp-memory-remote setup

• Interactive wizard for initial setup
• Tests connection automatically
• Saves secure configuration

diagnose - System Diagnostics

npx @ai-solutions.ru/mcp-memory-remote diagnose

• Checks configuration validity
• Tests server connectivity
• Verifies authentication
• Reports system health
• Saves diagnostic report

update-config - Update Claude Config

npx @ai-solutions.ru/mcp-memory-remote update-config ~/.config/claude/config.json

• Automatically updates your Claude Desktop config
• Creates backup before modification
• Preserves existing settings

--version - Show Version

npx @ai-solutions.ru/mcp-memory-remote --version

--help - Show Help

npx @ai-solutions.ru/mcp-memory-remote --help

🔧 Configuration Methods

1. Environment Variables (Highest Priority)

{
  "mcpServers": {
    "memory-remote": {
      "command": "npx",
      "args": ["-y", "@ai-solutions.ru/[email protected]"],
      "env": {
        "MCP_MEMORY_URL": "https://remotemem.coolify.ai-solutions.ru",
        "MCP_MEMORY_TOKEN": "your-token-here",
        "MCP_MEMORY_DEVICE_ID": "custom-device-id",
        "MCP_MEMORY_USER_ID": "custom-user-id"
      }
    }
  }
}

2. Configuration File

Location: ~/.mcp-memory-remote/config.json

{
  "url": "https://remotemem.coolify.ai-solutions.ru",
  "token": "your-token-here",
  "deviceId": "auto-generated",
  "userId": "your-username"
}

3. Demo Mode

{
  "env": {
    "MCP_MEMORY_DEMO": "true"
  }
}

4. Offline Mode

{
  "env": {
    "MCP_MEMORY_OFFLINE": "true"
  }
}

📋 Available Tools

remember - Save Information

Save data with optional tags for organization:

remember(key: "project_notes", value: "Important details...", tags: ["work", "urgent"])

recall - Retrieve Information

Search by key, query, or tags:

recall(key: "project_notes")
recall(query: "important", tags: ["work"])
recall(includeOffline: true)

forget - Delete Information

Remove specific entries:

forget(key: "old_notes")

list_memories - List All Memories

Browse stored data:

list_memories(tags: ["work"], limit: 20, includeOffline: true)

health_check - System Health Status

Check connection and system status:

health_check()

sync_offline - Sync Offline Data

Manually sync pending offline entries:

sync_offline()

🔍 Debug Modes

Basic Debug

MCP_DEBUG=true npx @ai-solutions.ru/mcp-memory-remote

Debug Levels

MCP_DEBUG_LEVEL=TRACE npx @ai-solutions.ru/mcp-memory-remote

Levels: ERROR, WARN, INFO, DEBUG, TRACE

Log to File

MCP_LOG_FILE=~/mcp-memory.log npx @ai-solutions.ru/mcp-memory-remote

🛡️ Reliability Features

Offline Support

• Automatically switches to offline mode when server is unavailable
• Stores data locally in ~/.mcp-memory-remote/offline/
• Syncs automatically when connection is restored
• Manual sync available via sync_offline tool

Auto-Retry Logic

• Intelligent retry with exponential backoff
• Configurable retry attempts
• Network-aware retry decisions
• Graceful degradation to offline mode

Health Monitoring

• Continuous connection monitoring
• Success rate tracking
• Automatic failover decisions
• Health status in tool descriptions

Configuration Fallbacks

1. Environment variables
2. User config file
3. Legacy config file
4. Demo mode
5. Offline mode

🔒 Security Features

• Tokens stored with 600 permissions (owner read/write only)
• No sensitive data in logs (production mode)
• Secure token validation
• Device ID anonymization
• HTTPS enforcement

🚨 Troubleshooting

Run Diagnostics First

npx @ai-solutions.ru/mcp-memory-remote diagnose

Common Issues

"Configuration not found"

Run setup: npx @ai-solutions.ru/mcp-memory-remote setup

"Authentication failed"

• Check your token in the config
• Verify server URL is correct
• Run diagnostics to test connection

"Server unavailable"

• Tool will automatically use offline mode
• Data will sync when connection returns
• Check server status at https://remotemem.coolify.ai-solutions.ru/health

"Permission denied"

• Check file permissions: ls -la ~/.mcp-memory-remote/
• Fix permissions: chmod 600 ~/.mcp-memory-remote/config.json

Enable Debug Logging

MCP_DEBUG=true MCP_LOG_FILE=~/mcp-debug.log npx @ai-solutions.ru/mcp-memory-remote

📊 Performance Tips

1. Use Tags: Organize data with tags for faster retrieval
2. Batch Operations: Group related operations together
3. Monitor Health: Check health_check() periodically
4. Clean Offline Storage: Remove synced entries regularly
5. Set Appropriate Limits: Use limit parameter in queries

🔄 Migration from Previous Versions

From v1.0.4 or earlier:

1. Backup existing config: cp ~/.mcp-memory-remote/config.json ~/.mcp-memory-remote/config.backup.json
2. Install new version: npm install -g @ai-solutions.ru/[email protected]
3. Run diagnostics: mcp-memory-remote diagnose
4. Update Claude config: mcp-memory-remote update-config ~/.config/claude/config.json

🤝 Support

• Documentation: https://install.ai-solutions.ru/mcp-memory-remote/
• Issues: https://github.com/ai-solutions-ru/mcp-memory-remote/issues
• Email: [email protected]

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

Built with the Model Context Protocol SDK by Anthropic.

v1.0.5 - Maximum Reliability Release

• Enhanced error handling and recovery
• Offline mode with automatic sync
• Health monitoring and diagnostics
• Improved configuration management
• Better logging and debugging