Mint — Safe Mac Storage Actions

Mint MCP サーバー

スマートなストレージを、あなたとエージェントに。 Mint は、ストレージ分析、ファイルを保持したままの最適化、確認後のクリーンアップ、Auto Care、ファイル整理、メモリ管理を、1 つの Mac ワークフローにまとめます。

製品の仕組み

Mint は、最適化可能、安全にクリーンアップ可能、個人用、保持を区別します。条件を満たす重複ファイルは、両方のファイルを保持したままストレージを共有できます。対応する Codex の最適化では、会話を続けるために必要な画像を保持します。特定されたキャッシュや残存ファイルと、個人用ファイル、会話、メディアでは、その影響が異なります。必要なデータ、使用中のデータ、保護されたデータ、不確かなデータは変更されません。Mint の実行中、Auto Care はユーザーが有効にした範囲とスケジュール内で、対応するルーチンを継続します。

このランチャーが公開するのは Direct 版で対応しているエージェントインターフェースであり、アプリの全機能ではありません。エージェントはストレージを調査し、ネイティブ MCP クリーンアップツールを使用できます。一方、会話の最適化、メディアの削除、ストレージの共有、フォルダーの設定、メモリ管理はアプリ内で確認して行います。Auto Care の利用には有料アクセスが必要で、利用可能な機能はエディションによって異なります。ワークフロー全体と現在の制限および正式な製品情報をご覧ください。

この 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 でビルドし、生成されたファイルを Settings → Extensions → Advanced Settings → Install Extension からインストールしてください。

ツール

• 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日間の操作履歴に記録され、履歴エントリーとゴミ箱に移動された項目の両方が利用可能な間は元に戻せます。エージェントには完全削除の手段は提供されていません。

サーバーは、クライアントに Mint の確認済み操作を使用するよう求めます。ただし、エージェントが別の削除ツールを呼び出すことは防げません。スキャンを実行しても、ファイル変更へのユーザーの同意を得たことにはなりません。同じボリューム上のファイルをゴミ箱に移動しても、それだけではディスク容量は回復しません。移動したバイト数を、物理的に回復したバイト数として報告しないでください。

ライセンス

このリポジトリのランチャーは MIT ライセンスです。Mint は DZG Studio LLC が独自の利用条件に基づいて公開している商用ソフトウェアです。