Rewind MCP

🚀 🔄 Rewind MCP

Claude Code CLI用のスマートで軽量なチェックポイント管理MCPサーバーです。

✨ 主な機能

• 🎯 スマートなチェックポイント管理：エージェントが何らかの変更を加える前に、自動的にプロジェクトの状態をチェックポイントとして保存します。
• 🔄 完全なアンドゥサポート：変更されたファイルを元に戻し、削除されたファイルを復元し、不要なファイルを削除することができます。
• ⚡ 高速な複数ファイル復元：複数のファイルにまたがる変更を瞬時に元に戻すことができます。

💻 使用例

基本的な使用法

👤 ユーザー: "エラーハンドリングを追加して..."

🤖 エージェント: 変更前にチェックポイントを作成しています...
✅ チェックポイント: "エラーハンドリングを追加する前"

🤖 エージェント: "コードにエラーハンドリングを追加しました"

👤 ユーザー: "これで流れが崩れてしまいます。元に戻してください"

🤖 エージェント: チェックポイントからファイルを復元しています...
✅ エラーハンドリングを追加する前の状態にファイルを復元しました

高度な使用法

👤 ユーザー: "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 (削除済み)

👤 ユーザー: "完璧です！今度はカスタムエラークラスを使ってエラーハンドリングを実装して"

🤖 エージェント: カスタムエラークラスを使ったエラーハンドリングを実装します。

[エージェントが src/api/routes.js を変更]
✅ チェックポイントを作成し、スタックに追加: "src/api/routes.js を変更"

[エージェントが src/utils/CustomError.js を作成]
✅ チェックポイントを作成し、スタックに追加: "src/utils/CustomError.js を作成"

🤖 エージェント: カスタムエラークラスを使ったエラーハンドリングを実装しました。これにより、エラーの分類とレスポンスのフォーマットが改善されます。

📦 インストール

インストール手順

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. リポジトリをフォークします。
2. 新しい機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

MITライセンスです。詳細は LICENSE ファイルを参照してください。

🙋‍♂️ サポート

• 📖 ドキュメント
• 🐛 イシュートラッカー
• 💬 ディスカッション

Claude Codeエコシステムのために❤️ で作られました