MCP-Backup-Server 是一个专门为 AI 智能体和代码编辑工具设计的 MCP 服务器,用于提供文件备份与恢复功能。该项目已在 Cursor 和 Windsurf 编辑器中经过测试。
用途
该服务器旨在解决与 Git 不同的场景需求:它创建即时、有针对性的备份,并保留智能体上下文和推理信息。它比 Git 更简单,适合单次操作的安全保护,无需提交信息或分支即可使用,无需仓库初始化,适合 AI 智能体进行关键更改前的紧急“保存点”。
主要能力
- 保留智能体上下文和推理
- 创建有针对性和最小化的备份
- 支持文件和文件夹操作
- 维护版本历史
- 提供恢复安全性
- 使用模式过滤
- 追踪操作
- 允许取消
使用方式
通过 Smithery 安装:可为 Claude Desktop 自动安装 Backup Server。
手动安装:需配置以下环境变量:
- BACKUP_DIR:备份目录(默认 ./.code_backups)
- EMERGENCY_BACKUP_DIR:紧急备份目录(默认 ./.code_emergency_backups)
- MAX_VERSIONS:版本数量限制(默认 10)
编辑器配置:
- Windsurf MCP 配置:按相应格式配置。
- Cursor:创建 .cursor/mcp.json 并采用类似配置。
支持的工具操作包括:
- 文件操作:backup_create(带上下文创建备份)、backup_list(列出可用备份)、backup_restore(带安全备份的恢复)
- 文件夹操作:backup_folder_create(带模式过滤的备份)、backup_folder_list(列出文件夹备份)、backup_folder_restore(恢复文件夹结构)、backup_list_all(列出所有备份)
- mcp_cancel:取消操作
适用场景
仅在真正需要时创建备份:
- 重构之前:更改重要代码时
- 删除文件夹之前:重新组织项目结构时
- 多个相关更改:更新多个关联文件时
- 恢复重大工作:继续重要更改时
- 恢复之前:在恢复前创建安全备份
应保持备份最小化且有目的性,并记录每次备份的原因。
限制
该工具不适用于长期版本追踪,协作功能有限,没有合并或冲突解决,没有分布式备份能力,不替代正规的版本控制系统。它存储完整的文件副本而非差异。如需正规的版本历史、协作和项目管理,应使用 Git。