MCP Backup Server

by hexitex
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Offers a complementary approach to Git with simpler, AI-focused backup capabilities for code. Unlike Git, the system creates instant backups with agent context without requiring commit messages or repository initialization, suitable for emergency 'save points' during edits.

  • Uses npm for installation and dependencies, with configuration settings for the MCP server that can be managed through npm scripts and environment variables.

  • Provides backup and restoration capabilities for TypeScript files, allowing targeted backups with pattern filtering (*.ts) and preserving agent context when making critical changes to TypeScript code.

Servidor de respaldo MCP

Un servidor MCP especializado que ofrece funciones de copia de seguridad y restauración para agentes de IA y herramientas de edición de código. Probado en los editores Cursor y Windsurf.

Repositorio: https://github.com/hexitex/MCP-Backup-Server

¿Por qué usar esto (y no Git)?

Este sistema tiene un propósito diferente al de Git:

Ventajas:

  • Crea copias de seguridad instantáneas y específicas con el contexto del agente
  • Más simple que Git para la seguridad de una sola operación
  • Conserva el proceso de pensamiento y la intención en las copias de seguridad.
  • No se requieren mensajes de confirmación ni ramificaciones
  • Mejor para los agentes de IA que realizan cambios críticos
  • Funciona sin inicialización del repositorio
  • Más rápido para "puntos de guardado" de emergencia durante las ediciones

Contras:

  • No para seguimiento de versiones a largo plazo
  • Funciones de colaboración limitadas
  • Sin fusión ni resolución de conflictos
  • No hay capacidades de copia de seguridad distribuida
  • No reemplaza un control de versiones adecuado
  • Almacena copias completas de archivos en lugar de diferencias

Cuándo usarlo: antes de realizar ediciones riesgosas, reestructurar carpetas o cuando necesite copias de seguridad de seguridad rápidas con contexto.

Cuándo usar Git en su lugar: para un historial de versiones adecuado, colaboración y gestión de proyectos.

Características

  • Preserva el contexto y el razonamiento del agente.
  • Crea copias de seguridad mínimas y específicas
  • Admite operaciones con archivos y carpetas
  • Mantiene el historial de versiones
  • Proporciona seguridad de restauración
  • Utiliza filtrado de patrones
  • Operaciones de seguimiento
  • Permite la cancelación

Configuración

# Install dependencies npm install # Build TypeScript files npm run build # Start the backup server npm start

Configuración

Env:

  • BACKUP_DIR : Directorio de respaldo (./.code_backups)
  • EMERGENCY_BACKUP_DIR : Copias de seguridad de emergencia (./.code_emergency_backups)
  • MAX_VERSIONS : Límite de versiones (10)

Configurar en el editor:

Configuración del MCP de Windsurf:

{ "mcpServers": { "backup": { "command": "node", "args": ["./dist/index.js"], "env": { "BACKUP_DIR": "./.code_backups", "EMERGENCY_BACKUP_DIR": "./.code_emergency_backups", "MAX_VERSIONS": "20" } } } }

Cursor: crea .cursor/mcp.json con una configuración similar.

Herramientas

Operaciones con archivos

  • backup_create : Crea una copia de seguridad con contexto
  • backup_list : Lista de copias de seguridad disponibles
  • backup_restore : Restaurar con copia de seguridad de seguridad

Operaciones de carpeta

  • backup_folder_create : Copia de seguridad con filtrado de patrones
  • backup_folder_list : Lista de copias de seguridad de carpetas
  • backup_folder_restore : Restaurar la estructura de carpetas

Gestión

  • backup_list_all : Listar todas las copias de seguridad
  • mcp_cancel : Cancelar operaciones

Cuándo utilizar copias de seguridad

Cree copias de seguridad solo cuando sea realmente necesario:

  1. Antes de refactorizar : al cambiar código importante
  2. Antes de eliminar carpetas : al reorganizar la estructura del proyecto
  3. Múltiples cambios relacionados : al actualizar varios archivos conectados
  4. Reanudación de trabajos importantes : cuando se continúan cambios significativos
  5. Antes de restaurar : crear una copia de seguridad de seguridad antes de restaurar

Mantenga las copias de seguridad al mínimo y con un propósito definido. Documente por qué es necesaria cada copia.

Reglas para copiar y pegar

Always try to use the backup MCP server for operations that require a backup, listing backups and restoring backups. Only backup before critical code changes, folder removal, changes to multiple related files, resuming major work, or restoring files. Keep backups minimal and focused only on files being changed. Always provide clear context for why a backup is being created. Use pattern filters to exclude irrelevant files from folder backups. Use relative file paths when creating backups. Create emergency backups before restore operations. Clean up old backups to maintain system efficiency. Backup tools: backup_create, backup_list, backup_restore, backup_folder_create, backup_folder_list, backup_folder_restore, backup_list_all, mcp_cancel.

Para usuarios humanos

Comandos simples como estos al principio puede que tengas que mencionar la herramienta MCP

# Back up an important file "Back up my core file before refactoring" # Back up a folder before changes "Create backup of the API folder before restructuring" # Find previous backups "Show me my recent backups" # Restore a previous version "Restore my core file from this morning"

Ejemplos de agentes

Copias de seguridad rápidas

// Before project changes { "name": "mcp0_backup_folder_create", "parameters": { "folder_path": "./src", "include_pattern": "*.{js,ts}", "exclude_pattern": "{node_modules,dist,test}/**", "agent_context": "Start auth changes" } } // Before core fix { "name": "mcp0_backup_create", "parameters": { "file_path": "./src/core.js", "agent_context": "Fix validation" } }

Reanudar sesión

// View recent work { "name": "mcp0_backup_list_all", "parameters": { "include_pattern": "src/**/*.js" } } // Get last version { "name": "mcp0_backup_restore", "parameters": { "file_path": "./src/core.js", "timestamp": "20250310-055950-000", "create_emergency_backup": true } }

Cambios fundamentales

// Critical update { "name": "mcp0_backup_create", "parameters": { "file_path": "./src/core.js", "agent_context": "Add validation" } } // Module update { "name": "mcp0_backup_folder_create", "parameters": { "folder_path": "./src/api", "include_pattern": "*.js", "exclude_pattern": "test/**", "agent_context": "Refactor modules" } }

Puntos de restauración

// Check versions { "name": "mcp0_backup_list", "parameters": { "file_path": "./src/core.js" } } { "name": "mcp0_backup_folder_list", "parameters": { "folder_path": "./src/api" } } // File restore { "name": "mcp0_backup_restore", "parameters": { "file_path": "./src/core.js", "timestamp": "20250310-055950-000", "create_emergency_backup": true } } // Folder restore { "name": "mcp0_backup_folder_restore", "parameters": { "folder_path": "./src/api", "timestamp": "20250310-055950-000", "create_emergency_backup": true } }

Administrar

// List recent { "name": "mcp0_backup_list_all", "parameters": { "include_pattern": "src/**/*.js" } } // Stop backup { "name": "mcp0_mcp_cancel", "parameters": { "operationId": "backup_1234" } }

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor especializado que proporciona capacidades de respaldo y restauración para agentes de IA y herramientas de edición de código, creando copias de seguridad instantáneas y específicas con preservación del contexto.

  1. Why Use This (Not Git)
    1. Features
      1. Setup
        1. Config
          1. Tools
            1. File Operations
            2. Folder Operations
            3. Management
          2. When to Use Backups
            1. Rules for Copy-Paste
              1. For Human Users
                1. Agent Examples
                  1. Quick Backups
                  2. Resume Session
                  3. Core Changes
                  4. Restore Points
                  5. Manage
                2. License
                  ID: nghymq13i7