MCP Multi Edit

Editing Files

When making multiple edits to the same file or across multiple files, prefer using the multi_edit and multi_edit_files MCP tools over the built-in Edit tool. These batch edits atomically in a single call.

これで完了です。Claudeは、適切なツールとして `multi_edit` を使用するようになります。

> **表示名:** Claude Codeは、`mcpServers` のキー名をサーバーの表示名として使用します。キーを好きな名前に変更することができます。

**別の方法:** CLIを使用したワンライナー

```bash
claude mcp add --transport stdio multi-edit -- npx -y @essentialai/mcp-multi-edit

注意: CLIは、単純な名前（文字、数字、ハイフン、アンダースコア）のみを受け付けます。完全なブランド表示名を使用するには、上記の .mcp.json の方法を使用してください。

Claude Desktop

設定ファイル（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "Multi Edit from Essential AI Solutions (essentialai.uk)": {
      "command": "npx",
      "args": ["-y", "@essentialai/mcp-multi-edit"]
    }
  }
}

Claude Desktopを再起動します。

完全なインストールガイド: docs/installation.md

✨ 主な機能

• アトミック操作 -- すべての編集が成功するか、または何も適用されず、部分的な状態は発生しません。
• マルチファイルロールバック -- いずれかのファイルでエラーが発生した場合、以前に変更されたすべてのファイルが自動的に復元されます。
• ドライランプレビュー -- 変更を適用する前に、正確に何が変更されるかを確認できます。
• 自動バックアップ -- すべての編集の前に .bak ファイルが作成されます（backup: false で無効にできます）。
• 構造化エラー -- 自動リトライのための回復ヒント付きの機械可読エラーコード。
• 競合検出 -- old_string が複数の場所に一致する場合に警告します。
• パス検証 -- 絶対パスの強制、シンボリックリンクの解決、存在チェック。

📦 インストール

必要条件

• Node.js 20以上
• Claude Code または Claude Desktop

💻 使用例

基本的な使用法

multi_edit -- 単一ファイルの複数編集

1つのファイルに対して複数の検索と置換操作をバッチ処理します。編集は順次かつアトミックに適用されます。

{
  "file_path": "/project/src/app.ts",
  "edits": [
    { "old_string": "const oldName = getValue()", "new_string": "const newName = getValue()" },
    { "old_string": "console.log", "new_string": "logger.info", "replace_all": true }
  ]
}

multi_edit_files -- 複数ファイルのアトミック操作

複数のファイル間で編集を調整します。いずれかのファイルでエラーが発生した場合、すべてのファイルが自動的にロールバック されます。

{
  "files": [
    {
      "file_path": "/project/src/types.ts",
      "edits": [
        { "old_string": "interface UserData {", "new_string": "interface UserProfile {" }
      ]
    },
    {
      "file_path": "/project/src/api.ts",
      "edits": [
        { "old_string": "UserData", "new_string": "UserProfile", "replace_all": true }
      ]
    }
  ]
}

詳細な使用ガイドと例: docs/usage.md

🔧 技術詳細

エラーコード

retryable が true の場合、Claudeはレスポンス内の recovery_hints を読み取り、入力を調整して自動的にリトライします。

トラブルシューティングガイド: docs/troubleshooting.md

開発

npm install           # 依存関係のインストール
npm run build         # TypeScriptのコンパイル
npm test              # 264のテストを実行
npm run test:coverage # カバレッジレポート（90%以上）
npm run benchmark     # ベンチマークスイートを実行
npm run dev           # ウォッチモード

プロジェクト構造

src/
  index.ts              # MCPサーバーのエントリー（stdioトランスポート）
  server.ts             # サーバーファクトリとツール登録
  tools/
    multi-edit.ts       # multi_editツールのハンドラー
    multi-edit-files.ts # multi_edit_filesツールのハンドラー
  core/
    editor.ts           # ファイル編集エンジン（アトミックな読み取り-修正-書き込み）
    validator.ts        # Zod入力検証スキーマ
    reporter.ts         # 結果の整形と差分生成
    errors.ts           # エラー分類とエンベロープ作成
  types/
    index.ts            # TypeScriptの型定義