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 生態系統精心打造 ❤️