MCP バックアップサーバー

AIエージェントとコード編集ツールのバックアップと復元機能を提供する専用のMCPサーバー。CursorエディターとWindsurfエディターの両方でテスト済み。

リポジトリ: https://github.com/hexitex/MCP-Backup-Server

なぜこれを使うのか（Gitではない）

このシステムは Git とは異なる目的を果たします。

長所:

エージェントのコンテキストを使用して、ターゲットを絞った即時バックアップを作成します
単一操作の安全性に関しては Git よりもシンプル
バックアップで思考プロセスと意図を保存する
コミットメッセージやブランチは不要
AIエージェントが重要な変更を行うのに最適
リポジトリの初期化なしで動作します
編集中の緊急時の「セーブポイント」が高速化

短所:

長期的なバージョン追跡には適していません
限定的なコラボレーション機能
マージや競合解決なし
分散バックアップ機能なし
適切なバージョン管理の代替ではない
差分ではなく完全なファイルコピーを保存する

**使用する場合:**リスクのある編集、フォルダーの再構築の前、またはコンテキスト付きの迅速な安全バックアップが必要な場合。

**代わりに Git を使用する場合:**適切なバージョン履歴、コラボレーション、プロジェクト管理のため。

特徴

エージェントのコンテキストと推論を保存する
対象を絞った最小限のバックアップを作成する
ファイルとフォルダの操作をサポート
バージョン履歴を維持する
復元の安全性を提供
パターンフィルタリングを使用する
操作を追跡する
キャンセル可能

設定

# 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 : 操作をキャンセルする

バックアップを使用する場合

本当に必要な場合にのみバックアップを作成します。

リファクタリング前：重要なコードを変更する場合
フォルダを削除する前: プロジェクト構造を再編成する場合
複数の関連する変更: 複数の接続されたファイルを更新する場合
主要作業の再開：重要な変更を継続する場合
復元前: 復元前に安全なバックアップを作成してください

バックアップは最小限に抑え、目的を明確にしましょう。それぞれのバックアップが必要な理由を文書化しましょう。

コピー＆ペーストのルール

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

ライセンス

マサチューセッツ工科大学

MCP Backup Server

Integrations

MCP バックアップサーバー

なぜこれを使うのか（Gitではない）

特徴

設定

設定

ツール

ファイル操作

フォルダー操作

管理

バックアップを使用する場合

コピー＆ペーストのルール

人間のユーザー向け

エージェントの例

クイックバックアップ

セッションを再開する

コアの変更

復元ポイント

管理

ライセンス

Integrations

MCP バックアップ サーバー

なぜこれを使うのか（Gitではない）

特徴

設定

設定

ツール

ファイル操作

フォルダー操作

管理

バックアップを使用する場合

コピー＆ペーストのルール

人間のユーザー向け

エージェントの例

クイックバックアップ

セッションを再開する

コアの変更

復元ポイント

管理

ライセンス

MCP バックアップサーバー