Rewind MCP

🚀 🔄 Rewind MCP

Rewind MCP 是一款智能轻量级的检查点管理服务器，专为 Claude Code CLI 设计，能在代码操作中自动创建检查点，轻松实现代码状态的快速回退和恢复。

✨ 主要特性

• 🎯 智能检查点机制：在代码代理进行任何更改之前，自动为项目状态创建检查点。
• 🔄 完整的撤销支持：可恢复已修改的文件，找回已删除的文件，或移除不需要的文件。
• ⚡ 快速多文件恢复：能立即回退多个文件的更改。

💻 使用示例

基础用法

👤 用户："添加错误处理..."

🤖 代码代理：在修改前创建检查点...
✅ 检查点："添加错误处理之前"

🤖 代码代理："我已经为代码添加了错误处理"

👤 用户："这破坏了代码流程，请回退更改"

🤖 代码代理：从检查点恢复文件...
✅ 文件已恢复到添加错误处理之前的状态

高级用法

👤 用户："为我的 API 添加错误处理"

🤖 代码代理：我将为你的 API 文件添加全面的错误处理。

[代码代理修改 src/api/routes.js]
✅ 检查点已创建并压入栈中："修改了 src/api/routes.js"

[代码代理创建 src/middleware/errorHandler.js]
✅ 检查点已创建并压入栈中："创建了 src/middleware/errorHandler.js"

🤖 代码代理：我已经为你的 API 路由添加了 try-catch 块和集中式错误处理，并创建了一个新的错误中间件。

👤 用户："实际上，我想尝试另一种方法。你能展示一下有哪些可用的检查点吗？"

🤖 代码代理：我将展示可用的检查点。
📋 可用检查点：
  1. "创建了 src/middleware/errorHandler.js" - [最新]
  2. "修改了 src/api/routes.js"
  3. "数据库架构更新"
  4. "项目初始设置"

👤 用户："回退最近的更改"

🤖 代码代理：我将从最近的检查点恢复文件。
✅ 撤销操作："创建了 src/middleware/errorHandler.js"
✅ 撤销操作："修改了 src/api/routes.js"
已恢复的文件：
  - src/api/routes.js（已恢复）
  - src/middleware/errorHandler.js（已删除）

👤 用户："完美！现在使用自定义 Error 类来实现错误处理"

🤖 代码代理：我将使用自定义 Error 类的方法来实现错误处理。

[代码代理修改 src/api/routes.js]
✅ 检查点已创建并压入栈中："修改了 src/api/routes.js"

[代码代理创建 src/utils/CustomError.js]
✅ 检查点已创建并压入栈中："创建了 src/utils/CustomError.js"

🤖 代码代理：我已经使用自定义 Error 类实现了错误处理，该类提供了更好的错误分类和响应格式。

📦 安装指南

安装步骤

git clone https://github.com/khalilbalaree/Rewind-MCP.git
cd Rewind-MCP

然后，

npm install
npm run build

Claude Code 配置

将此服务器添加到你的 Claude Code MCP 配置中：

基于用户的配置（全局）

编辑 ~/Library/Application Support/Claude/claude_code_config.json：

{
  "mcpServers": {
    "Rewind-MCP": {
      "command": "node",
      "args": ["/absolute/path/to/Rewind-MCP/dist/index.js"],
      "env": {}
    }
  }
}

项目特定的配置（可选）

为了更方便地进行项目共享和版本控制，在你的项目目录中创建一个 .mcp.json 文件：

# 在你的项目目录中
cat > .mcp.json << 'EOF'
{
  "mcpServers": {
    "Rewind-MCP": {
      "command": "node",
      "args": ["/absolute/path/to/Rewind-MCP/dist/index.js"],
      "env": {}
    }
  }
}
EOF

📚 详细文档

可供 Claude 使用的功能调用

只需提出请求，它将完成其余操作。

• checkpoint(files, description) - 在更改前创建检查点
• undo(file) - 恢复到上一个检查点
• list_undos() - 显示可用的检查点
• cleanup - 清理所有检查点
• status() - 显示当前检查点状态

🤝 贡献代码

1. Fork 仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add amazing feature')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙋‍♂️ 支持

• 📖 文档
• 🐛 问题跟踪
• 💬 讨论

为 Claude Code 生态系统精心打造 ❤️