code-editor-mcp

## code-editor 面向多客户端并发、安全沙箱、编码感知的代码编辑 MCP 服务器。 > 路径访问更新：**所有参数必须是绝对路径**。除 `read_files` 外，其余文件/目录工具仍校验是否落在允许目录列表内。`CODE_EDIT_ROOT` 只是安全标记，不做访问边界或相对路径解析；访问新目录请用 `config_ops(action="set_root", path="...")` 加入允许列表。 ### 安装与运行 ```bash # 安装（pip 或 uv 均可，包名 code-editor-mcp） pip install code-editor-mcp # 或 uv pip install code-editor-mcp # 更新最新版 pip install -U code-editor-mcp # 直接启动 CLI 入口 code-editor # 若从源码运行 uv sync uv run python server.py ``` 关键环境变量： - `CODE_EDIT_ROOT`：安全标记（默认启动时的 CWD），不做访问边界，也不参与相对路径解析。 - `CODE_EDIT_ALLOWED_ROOTS_FILE`：允许目录持久化 JSON，默认 `tools/.code_edit_roots.json`。 - `CODE_EDIT_ALLOWED_DIRECTORIES`：逗号分隔允许目录列表（兼容旧的 `CODE_EDIT_ALLOWED_ROOTS`）。 环境变量一览： | 变量 | 作用 | 默认值 | | --- | --- | --- | | `CODE_EDIT_ROOT` | 安全标记（非访问边界，不做路径解析） | 当前工作目录 | | `CODE_EDIT_ALLOWED_ROOTS_FILE` | 允许目录持久化文件 | `tools/.code_edit_roots.json` | | `CODE_EDIT_ALLOWED_DIRECTORIES` (兼容 `CODE_EDIT_ALLOWED_ROOTS`) | 额外允许目录（逗号分隔） | 空 | | `CODE_EDIT_FILE_READ_LINE_LIMIT` | （legacy）内部 `read_file` 默认行数上限；`read_files` v2 使用 `page_line_count/max_lines_per_snippet` 控制输出 | 1000 | | `CODE_EDIT_FILE_WRITE_LINE_LIMIT` | `file_ops` 写入行数警戒 | 50 | ### 设计要点 - 允许目录列表：默认允许用户主目录；路径需落在允许目录内，否则拒绝。`config_ops(action="set_root")` 仅将目录加入允许列表并更新安全标记，不做路径拼接。 - 持久允许目录：`config_ops(action="set_root")` 成功后写入 JSON，可跨会话复用。 - 乐观锁：写/删类支持秒或纳秒级 `expected_mtime`，10ms 容忍；写入走原子写避免部分落盘。 - 默认忽略：`.git`、`__pycache__`、`node_modules`、`.DS_Store`、`.env*`、`.venv`、`*.log`、`*.pem`；`ignore_patterns` 传空字符串/空列表可关闭默认忽略。 - 编码感知：`read_files` v2 默认逐文件 `auto` 检测/复用编码（基于最新 mtime 刷新的元信息缓存）；如自动结果乱码，可在每个 request 里显式传 `encoding` 覆盖。 - 安全删除：禁止删除当前根/其祖先/关键系统目录。 ### MCP 工具（code-editor） #### 文件系统工具 | 名称 | 工具 | 功能 | 主要参数/说明 | 常见误用 | | --- | --- | --- | --- | --- | | `config_ops` | `config_ops(action, path=None)` | 允许目录管理 + 元信息 | `action`=set_root/list_roots/get_info；`path` 仅 set_root/get_info 需要 | 拼错 action；误以为 list_roots 需要 path | | `read_files` | `read_files(requests, default_encoding="auto", page_line_count=400, max_snippets=64, max…