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类型定义