Mint — Safe Mac Storage Actions

Mint MCP 服务

智能存储，为你和你的 Agent 打造。 Mint 将存储分析、保留文件的优化、经审核的清理、自动维护、文件整理和记忆管理整合到一个 Mac 工作流中。

产品方法

Mint 区分可优化、可安全清理、属于你和保留。符合条件的重复副本可以共享存储空间，同时保留两个文件；受支持的 Codex 优化会保留继续对话所需的图片。已识别的缓存和残留文件，与个人文件、对话和媒体造成的影响各不相同。必需、正在使用、受保护或无法确定的数据会保持不变。Mint 运行期间，自动维护会在用户启用的范围和计划内继续执行受支持的例行任务。

此启动器仅提供 Direct 版支持的 Agent 接口，并非应用的所有功能。Agent 可以检查存储并使用原生 MCP 清理工具；对话优化、媒体移除、存储共享、文件夹设置和记忆管理需在应用中审核。自动维护需要付费权限，且各版本的可用性不同。请参阅完整工作流和当前限制以及规范产品信息。

此 npm 包是一个小型开源启动器。它会定位 Mint Direct 版附带的签名版 mint-cli，验证 DZG Studio LLC 代码签名，并启动其本地 stdio MCP 服务。它不包含 Mint 本身，也不会向 DZG Studio 发送存储数据。工具结果会共享给你连接的 MCP 客户端；该客户端可能会使用远程 AI 提供商。

要求

• macOS 14 Sonoma 或更高版本
• Node.js 18 或更高版本
• 从 https://mintstorage.app/ 获取的 Mint Direct（macOS 14 或更高版本）；请保持原生应用为最新版本

安装 Mint，并从 Finder 启动一次。Mint 通常会将 mint-cli 链接到 /opt/homebrew/bin 或 /usr/local/bin；启动器也可以使用 /Applications/Mint.app 中的二进制文件。

目前已发布的 npm 启动器版本为 1.0.1。工具由原生应用提供，因此仅安装启动器不会更新扫描器或执行引擎。Setapp 和 Mac App Store 版本不包含 CLI/MCP。请参阅当前产品和版本信息以及 Direct 定价。

配置 MCP 客户端

{
  "mcpServers": {
    "mint": {
      "command": "npx",
      "args": ["-y", "@dzg-studio/[email protected]"]
    }
  }
}

或者，如果 mint-cli 已在 PATH 中：

mint-cli mcp

设置 MINT_CLI_PATH=/absolute/path/to/mint-cli，即可使用非标准安装路径。

Claude Desktop 扩展

公开仓库中的 mcpb/ 源代码会将此启动器打包为 Claude Desktop 一键式扩展。使用 npx -y @anthropic-ai/mcpb pack mcpb/ mint-safe-mac-storage.mcpb 构建，然后从设置 → 扩展 → 高级设置 → 安装扩展安装生成的文件。

工具

• mint_status — 磁盘趋势、近期活动和受管理文件夹的状态。
• mint_why — 存储增长归因或涉及某一路径的操作。
• mint_scan — 只读的可回收空间调查。
• mint_agents — 来自 Mint 最新扫描的 AI 工具存储信息：各工具的用量、对话时间和状态，以及可压缩的已归档 Codex 媒体。
• mint_recent 和 mint_activity — 操作历史和原因。
• mint_rules — 列出清理规则并进行试运行。
• mint_execute — 带操作理由的日志记录式清理，并返回 batchId。

工具架构和支持的操作取决于已安装的原生应用。执行前请读取当前工具架构；不要将旧示例重复用作授权依据。

安全模型

mint_execute 只能将项目移到废纸篓，并且仅限 Mint 的清理根目录或用户管理的文件夹。受保护的路径会被拒绝，需要审核的路径必须在 Mint.app 中确认。可恢复的操作会记录在 Mint 的 90 天操作日志中；只要日志条目和底层已移至废纸篓的项目仍然可用，就可以撤销。Agent 无法执行永久删除。

该服务会要求客户端使用经过审核的 Mint 操作，但无法阻止 Agent 调用其他删除工具。扫描并不代表用户同意更改文件。在同一卷上将文件移至废纸篓本身不会释放磁盘空间；请勿将已移动的字节数报告为实际回收的字节数。

许可证

此代码库中的启动器采用 MIT 许可证。Mint 是由 DZG Studio LLC 根据其自身条款发布的商业软件。