MCP Backup Server

MCP备份服务器

一个专门的MCP服务器，为AI代理和代码编辑工具提供备份和恢复功能。在Cursor和Windsurf编辑器中进行了测试。

存储库：

为什么使用这个（不是Git）

这个系统的用途与Git不同：

赞成的意见：

• 使用代理上下文创建即时、有针对性的备份
• 比Git更简单，更安全
• 在备份中保留思维过程和意图
• 无需提交消息或分支
• 更适合AI代理进行关键更改
• 无需存储库初始化即可工作
• 在编辑过程中更快地获得紧急“保存点”

欺骗：

• 不适用于长期版本跟踪
• 有限的协作功能
• 无合并或冲突解决
• 没有分布式备份功能
• 不能替代正确的版本控制
• 存储完整的文件副本而不是差异

何时使用： 在进行有风险的编辑、文件夹重组之前，或者当您需要使用上下文进行快速安全备份时。

何时改用Git： 用于正确的版本历史记录、协作和项目管理。

特性

• 保留代理上下文和推理
• 创建有针对性的最小备份
• 支持文件和文件夹操作
• 维护版本历史记录
• 提供恢复安全
• 使用模式过滤
• 跟踪操作
• 允许取消

设置

通过Smithery安装

通过以下方式自动安装克劳德桌面备份服务器 史密瑟里:

npx -y @smithery/cli install @hexitex/MCP-Backup-Server --client claude

手动安装

# Install dependencies
npm install

# Build TypeScript files
npm run build

# Start the backup server
npm start

配置

环境：

• BACKUP_DIR：备份目录（./.code_backups）
• EMERGENCY_BACKUP_DIR：紧急备份（./.code_Emergency_backups）
• MAX_VERSIONS：版本限制（10）

在编辑器中配置：

Windsurf MCP配置：

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

光标：创建 .cursor/mcp.json 配置类似。

工具

文件操作

• backup_create：使用上下文创建备份
• backup_list：列出可用备份
• backup_restore：使用安全备份进行恢复

文件夹操作

• backup_folder_create：使用模式过滤进行备份
• backup_folder_list：列出文件夹备份
• backup_folder_restore：还原文件夹结构

管理

• backup_list_all：列出所有备份
• mcp_cancel：取消操作

何时使用备份

仅在真正需要时创建备份：

1. 重构之前：更改重要代码时
2. 删除文件夹之前：重组项目结构时
3. 多项相关变更：更新多个连接的文件时
4. 恢复主要工作：当继续发生重大变化时
5. 恢复之前：在还原之前创建安全备份

保持备份最少且有目的。记录需要每次备份的原因。

复制粘贴规则

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.

对于人类用户

像这样的简单命令一开始你可能不得不提到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"

代理示例

快速备份

// 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"
  }
}

恢复会话

// 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
  }
}

核心变化

// 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"
  }
}

恢复点

// 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
  }
}

管理

// List recent
{
  "name": "mcp0_backup_list_all",
  "parameters": {
    "include_pattern": "src/**/*.js"
  }
}

// Stop backup
{
  "name": "mcp0_mcp_cancel",
  "parameters": {
    "operationId": "backup_1234"
  }
}

许可证

麻省理工学院