MCP-CLEAN

MCP-CLEAN 是用于管理本机上已获准项目文件夹的本地控制中心。

MCP-CLEAN 架构

• server.mjs - MCP 服务器及工具实现

• config/allowed-roots.json - 已获准的项目根目录

• backups/ - 项目归档和文件备份

• logs/ - 运行日志

• logs/actions.log - 操作审计跟踪

• temp/ - 临时运行时文件

• exchange/ - 交换元数据与项目说明

• smoke-test.mjs - 本地冒烟测试

Related MCP server: Node Dev MCP Server

所有可用工具

• ping

• list_directory

• read_file

• write_file

• project_status

• backup_project

• health_check

• git_status_all

• git_checkpoint

• restore_project

• system_status

• project_scan

• safe_change

项目操作

• 所有操作均限定在 config/allowed-roots.json 中的路径范围内。

• system_status 和 git_status_all 只对已获准项目生效。

• project_scan 在不修改文件的前提下对项目结构进行深度检查。

• safe_change 通过 backup 和 checkpoint 预先准备项目。

备份

• 所有归档和文件备份仅保存到 F:\MCP-CLEAN\backups。

• 归档文件名包含时间戳。

• 备份结果包含路径、大小、项目信息及归档列表。

Git 检查点

• git_checkpoint 执行 stage、commit 并 push 到 origin main。

• 支持 dryRun，可在不做任何变更的情况下进行安全验证。

回滚

• 如果未指定 commit，restore_project 会列出可用的 checkpoint 提交。

• 回滚前会先创建备份。

• 然后对选定的 commit 执行 git reset --hard。

日志

• logs/mcp-clean.log - 运行记录。

• logs/actions.log - 操作日志，包含日期、工具、项目、操作及结果。

工作流程

1. 通过 health_check 检查健康状态。

2. 通过 system_status 查看系统状态。

3. 通过 project_scan 分析项目。

4. 通过 safe_change 准备更改。

5. 如有必要，通过 git_checkpoint 创建检查点。

6. 如有必要，通过 restore_project 回滚项目。