MCP Backup Server

What is MCP Backup Server?

MCP Backup Server is a specialized MCP server that provides backup and restoration capabilities for AI agents and code editing tools. It is tested in both Cursor and Windsurf editors.

How to use MCP Backup Server?

Install via Smithery (npx -y @smithery/cli install @hexitex/MCP-Backup-Server --client claude) or manually (install dependencies with npm install, build TypeScript with npm run build, start with npm start). Configure the server using environment variables (BACKUP_DIR, EMERGENCY_BACKUP_DIR, MAX_VERSIONS) and add it to your editor’s MCP configuration. Available tools include backup_create, backup_list, backup_restore, backup_folder_create, backup_folder_list, backup_folder_restore, backup_list_all, and mcp_cancel.

Key features of MCP Backup Server

• Preserves agent context and reasoning
• Creates targeted, minimal backups
• Supports file and folder operations
• Maintains version history
• Provides restore safety
• Uses pattern filtering
• Tracks operations
• Allows cancellation

Use cases of MCP Backup Server

• Backing up files before risky refactoring or critical changes
• Creating folder backups before restructuring or removing directories
• Maintaining restore points when making multiple related file changes
• Resuming major work by reviewing previous backup context
• Creating safety backups before restoring a previous version

FAQ from MCP Backup Server

How is MCP Backup Server different from Git?

It creates instant, targeted backups with agent context, is simpler for single-operation safety, preserves thought process, and doesn’t require commit messages or branching. However, it is not for long-term version tracking, lacks collaboration features, and stores complete file copies rather than diffs.

What dependencies are required to run MCP Backup Server?

Node.js and npm are required. The TypeScript files must be built using npm run build before starting the server.

Where are backups stored?

By default, backups are stored in ./.code_backups and emergency backups in ./.code_emergency_backups. These locations can be overridden with the BACKUP_DIR and EMERGENCY_BACKUP_DIR environment variables.

Is there a limit on the number of backup versions?

Yes, the maximum number of versions is controlled by the MAX_VERSIONS environment variable, which defaults to 10.

Can I cancel a running backup operation?

Yes, the mcp_cancel tool allows cancelling an ongoing backup operation by providing its operation ID.