MCP Multi Edit

編輯文件

當對同一個文件或多個文件進行多次編輯時，優先使用 multi_edit 和 multi_edit_files MCP工具，而非內置的編輯工具。這些工具可以在單個調用中以原子方式批量處理編輯操作。

就是這麼簡單，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": {
    "來自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 -- 單文件多次編輯

對一個文件進行多次查找並替換操作。編輯操作按順序且以原子方式應用。

{
  "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類型定義