#better-edit-tools-mcp (MoonBit)

A high-performance MCP（Model Context Protocol）file editing toolkit in MoonBit — atomic writes, function-scope detection, snapshot rollback, and fault-tolerant JSON parsing.

移植自同名 Go 项目 better-edit-tools-mcp（MIT License），使用 MoonBit 重写，面向 AI agent 工具链。

实验性项目：工具名称、参数和行为可能随设计演进调整。 不要将特定工具名硬编码到 prompt 中；推荐基于能力的动态工具选择。

工具描述支持中英双语，通过 --lang <zh|en> 启动时切换，省略时回退到 LANG 环境变量。

#安装

#方式一：从 mooncakes.io 添加依赖

moon add conglinyizhi/better-edit-tools-mcp

#方式二：从源码构建

git clone https://github.com/conglinyizhi/better-edit-tools-mcp-rebuild-moonbit.git
cd better-edit-tools-mcp-rebuild-moonbit
moon build --target native

#方式三：直接运行

moon run --target native cmd/main -- --help

#快速开始

#作为 MCP 服务器运行

moon run --target native cmd/main

moon run --target native cmd/main -- --lang zh

#作为命令行工具使用

# 读取文件
moon run --target native cmd/main -- read --file src/main.mbt --start 1 --end 10

# 查找函数范围
moon run --target native cmd/main -- func-range --file src/main.mbt --start 15

# 检查括号配对
moon run --target native cmd/main -- balance --file src/main.mbt

# 替换内容
moon run --target native cmd/main -- replace --file src/main.mbt --start 3 --end 5 -c "new content"

# 插入内容
moon run --target native cmd/main -- insert --file src/main.mbt --start 0 -c "// header comment"

# 删除行
moon run --target native cmd/main -- delete --file src/main.mbt --start 10 --end 12

# 写入文件
moon run --target native cmd/main -- write --file /tmp/out.txt -c "hello world"

#工具列表

#be-read

#be-replace

#be-insert

#be-delete

#be-write

#be-func-range

#be-tag-range

#be-balance

• false（默认）：仅输出不匹配项
• true：输出所有匹配对

#be-insert-chip

#be-trx

• action=status：查看当前快照队列
• action=rollback step=N：回滚最近 N 个快照
• action=commit：清空快照队列

#设计亮点

• 原子写入：所有文件修改经过"临时文件 → 重命名 → fsync"周期，进程崩溃不损坏文件
• isError 信号：错误正确报告 isError: true（符合 MCP 规范）
• 容错 JSON 解析：AI 生成内容常含反引号、${} 或未转义引号；be-write 自动回退到字符级提取
• 会话状态桥接：be-read 返回 viewed_code_id，be-replace 可用其校验行数一致性
• 中英双语：--lang zh 切换工具描述，参数名和行为不变
• MoonBit 原生：编译为原生二进制，零外部运行时依赖

#作为库使用

import {
  "conglinyizhi/better-edit-tools-mcp/read",
  "conglinyizhi/better-edit-tools-mcp/edit",
  "conglinyizhi/better-edit-tools-mcp/check",
}

fn main {
  // 读取文件
  let result = @read.be_read("src/main.mbt", start=1, end=10)

  // 纯逻辑操作（不涉及文件 I/O）
  let new_lines = @edit.replace_lines(original_lines, 3, 5, ["new", "content"])
}

#项目结构

better-edit-tools-mcp-rebuild-moonbit/
├── cmd/main/          # CLI / MCP 服务器入口
├── server/            # MCP JSON-RPC 服务器与工具路由
├── read/              # be-read 与 target 解析
├── write/             # be-write（原子写入、多文件、降级解析）
├── edit/              # be-replace / insert / delete / insert-chip / diff
├── check/             # be-balance / func-range / tag-range
├── chip/              # chip 缓存（失败参数保存与恢复）
├── snapshot/          # 编辑快照与事务（be-trx）
├── session/           # viewed_code_id 会话缓存
├── common/            # 公共类型、i18n、行处理、警告、二进制检测
├── error/             # BeError 错误类型
└── testutil/          # 测试辅助（临时文件/目录）

#参考项目

#许可证