Skip to main content
Glama

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: Local File Management 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 回滚项目。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables git repository operations through REST endpoints, providing access to repository status, diffs, and commits. Enforces security through configurable root directory allowlists for safe git operations.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables file system operations such as listing, reading, and creating files within a scoped local project directory. It provides a secure way to manage local files through standardized MCP tools built with FastMCP.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Exposes a secure, path-confined bridge to a local workspace and git remotes, enabling MCP clients to search, read, write, reset files, and perform git operations.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables localized file system operations such as listing, reading, editing, creating, deleting, and searching files, scoped to the directory where the server is invoked.
      6
      -