MCP 备份服务器

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

仓库地址: https://github.com/hexitex/MCP-Backup-Server

为什么使用它 (而不是 Git)

此系统与 Git 的用途不同：

优点：

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

缺点：

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

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

何时使用 Git： 用于适当的版本历史记录、协作和项目管理。

功能

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

设置

# 安装依赖
npm install

# 构建 TypeScript 文件
npm run build

# 启动备份服务器
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: 创建 .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. 恢复之前：在恢复之前创建安全备份

保持备份最小化和有目的性。记录每个备份的必要原因。

复制粘贴规则

对于需要备份的操作，列出备份和恢复备份，请始终尝试使用备份 MCP 服务器。
仅在关键代码更改、删除文件夹、更改多个相关文件、恢复主要工作或恢复文件之前进行备份。
保持备份最小化，并且仅关注正在更改的文件。
始终为创建备份的原因提供清晰的上下文。
使用模式过滤器从文件夹备份中排除不相关的文件。
创建备份时使用相对文件路径。
在恢复操作之前创建紧急备份。
清理旧备份以保持系统效率。
备份工具：backup_create、backup_list、backup_restore、backup_folder_create、backup_folder_list、backup_folder_restore、backup_list_all、mcp_cancel。

供人类用户使用

一开始像这样的简单命令，你可能需要提到 MCP 工具

# 备份一个重要的文件
"使用 MCP 工具备份我的核心文件，在重构之前"

# 备份一个文件夹，在更改之前
"使用 MCP 工具创建 API 文件夹的备份，在重组之前"

# 查找以前的备份
"使用 MCP 工具显示我最近的备份"

# 恢复以前的版本
"使用 MCP 工具从今天早上恢复我的核心文件"

代理示例

快速备份

// 在项目更改之前
{
  "name": "mcp0_backup_folder_create",
  "parameters": {
    "folder_path": "./src",
    "include_pattern": "*.{js,ts}",
    "exclude_pattern": "{node_modules,dist,test}/**",
    "agent_context": "开始身份验证更改"
  }
}

// 在核心修复之前
{
  "name": "mcp0_backup_create",
  "parameters": {
    "file_path": "./src/core.js",
    "agent_context": "修复验证"
  }
}

恢复会话

// 查看最近的工作
{
  "name": "mcp0_backup_list_all",
  "parameters": {
    "include_pattern": "src/**/*.js"
  }
}

// 获取最新版本
{
  "name": "mcp0_backup_restore",
  "parameters": {
    "file_path": "./src/core.js",
    "timestamp": "20250310-055950-000",
    "create_emergency_backup": true
  }
}

核心更改

// 关键更新
{
  "name": "mcp0_backup_create",
  "parameters": {
    "file_path": "./src/core.js",
    "agent_context": "添加验证"
  }
}

// 模块更新
{
  "name": "mcp0_backup_folder_create",
  "parameters": {
    "folder_path": "./src/api",
    "include_pattern": "*.js",
    "exclude_pattern": "test/**",
    "agent_context": "重构模块"
  }
}

还原点

// 检查版本
{
  "name": "mcp0_backup_list",
  "parameters": {
    "file_path": "./src/core.js"
  }
}

{
  "name": "mcp0_backup_folder_list",
  "parameters": {
    "folder_path": "./src/api"
  }
}

// 文件恢复
{
  "name": "mcp0_backup_restore",
  "parameters": {
    "file_path": "./src/core.js",
    "timestamp": "20250310-055950-000",
    "create_emergency_backup": true
  }
}

// 文件夹恢复
{
  "name": "mcp0_backup_folder_restore",
  "parameters": {
    "folder_path": "./src/api",
    "timestamp": "20250310-055950-000",
    "create_emergency_backup": true
  }
}

管理

// 列出最近的
{
  "name": "mcp0_backup_list_all",
  "parameters": {
    "include_pattern": "src/**/*.js"
  }
}

// 停止备份
{
  "name": "mcp0_mcp_cancel",
  "parameters": {
    "operationId": "backup_1234"
  }
}

许可证

MIT