AI エージェントから Karuzip を使う
公式サイト版 Karuzip 3.0.0 に MCP サーバー「karuzip-mcp」を同梱しています。中身の確認・一覧・破損チェックは最初から使え、解凍・圧縮・画像変換・PDF 操作はエージェントがあらかじめ許可されたフォルダーの中でだけ、一度内容を確認してから実行します。この機能は公式サイト版(インストーラー)に同梱されており、現在公開中の Microsoft Store 版には含まれません。
「AI エージェント」と書いているのは、判断するのは利用者が選んだエージェント側であり、Karuzip はその指示を受けて「実行」だけを行うためです。Karuzip 自身が AI として何かを自動判断することはありません。画面から使うときの解凍・圧縮の仕組み(対応形式・エンジン・検証)は、MCP 経由でもまったく同じです。
できること/できないこと
| 区分 | 操作 | 既定の扱い |
|---|---|---|
| 範囲指定なしで利用可 | 中身の確認 | 書き込み確認は不要 |
| 範囲指定なしで利用可 | 一覧(既定 2000 件・打切りを通知) | 書き込み確認は不要 |
| 範囲指定なしで利用可 | 破損チェック | 書き込み確認は不要 |
| 許可範囲内の読み取り | ファイル集合のメタデータを収集 | roots の指定が必要・書き込み確認は不要 |
| 許可範囲内の書き込み | 解凍・選択解凍・圧縮 | プレビュー後、同じ内容を確認して実行 |
| 許可範囲内の書き込み | 画像変換 | プレビュー後、同じ内容を確認して実行 |
| 許可範囲内の書き込み | PDF 結合・抽出・分割・並べ替え・圧縮 | プレビュー後、同じ内容を確認して実行 |
| 許可範囲内の書き込み | 画像・PDF の一括処理 | プレビュー後、同じ内容を確認して実行 |
| 範囲指定なしで利用可 | 操作定義・処理記録の読戻し・取消 | 書き込み確認は不要 |
公式サイト版 3.0.0 で提供している範囲です。共通の Action は 13 種類(書庫 6・ファイル収集 1・画像変換 1・PDF 5)で、一括処理 5 ツールと管理 3 ツールを含め MCP は 21 ツールです。roots が無い場合は書庫読み取り 3 ツールと管理 3 ツールの計 6 ツールだけが現れます。
含まれないもの: 現在公開中の Microsoft Store 版には同梱されません。ネットワーク経由の接続(stdio のみでポートは監視しません)、任意のコマンド実行や、ファイルの中身そのものを AI へ返すツールは提供しません。隔離(検疫)や自動処理の開始・停止も、エージェントからは操作できません。Karuzip の画面の中に「承認」ダイアログはまだなく、確認はエージェント側の操作確認と、上記の二段階の確認で行います。
3.0 の Microsoft Store 向け対応は、実際のパッケージで検証中です。提供範囲はまだ確定していません。このページの設定例は公式サイト版 3.0.0 に基づきます。
設定手順
エージェントの MCP 設定に、Karuzip をサーバーとして 1 つ追加します。共通のサーバー定義は次のとおりです(コマンド名 karuzip-mcp は、公式サイト版 3.0.0 のインストール後に PATH へ追加されます。新しく開いたターミナルからご確認ください)。
{ "mcpServers": { "karuzip": { "command": "karuzip-mcp" } } }
Claude Code
プロジェクト直下または利用者設定の .mcp.json に、上記の karuzip サーバー定義を追加します。作業フォルダーを Claude Code 側の roots(プロジェクトのワークスペース)として扱う場合はそのまま、別のフォルダーも許可したい場合は起動引数へ --allow-root を追加します。
{
"mcpServers": {
"karuzip": {
"command": "karuzip-mcp",
"args": ["--allow-root", "C:/Users/<ユーザー名>/Documents"]
}
}
}
Codex CLI
Codex CLI の設定ファイル(config.toml)に、MCP サーバーとして追加します。
[mcp_servers.karuzip]
command = "karuzip-mcp"
args = ["--allow-root", "C:/Users/<ユーザー名>/Documents"]
Cursor
Cursor の MCP 設定(mcp.json)に、上記と同じ karuzip サーバー定義を追加します。
{ "mcpServers": { "karuzip": { "command": "karuzip-mcp", "args": ["--allow-root", "C:/Users/<ユーザー名>/Documents"] } } }
作業フォルダーの指定について
解凍・圧縮(書き込み)は、エージェント側が申告する作業フォルダー(roots)、または起動引数 --allow-root で指定したフォルダーの中でだけ実行できます。どちらも指定が無いときは、追加の収集・書き込み・一括処理ツールは現れず、一覧は 21 から 6 ツールになります。ファイル集合の収集はメタデータの読み取りなので書き込み確認は不要ですが、媒体処理と書庫の書き込みには確認が必要です。--allow-root は複数回指定でき、複数のフォルダーを同時に許可できます。
安全のしくみ
- 読み取りは最初から、書き込みは許可した範囲だけ。エージェント側が指定した作業フォルダー(または起動時に指定したフォルダー)の外へは、解凍も圧縮もできません。範囲の指定が無いときは書き込み機能そのものが現れません。
- 書き込みは二段階。1 回目は「何を・どこへ・何件、重複はどう扱うか」の確認だけを返し、2 回目でその内容そのままを実行します。内容が 1 文字でも違えば実行しません。
- すべて処理記録に残ります。成功も失敗も、画面からの操作と同じ「処理記録」に同じ形式で記録されます。
- パスワードは AI に渡りません。暗号化書庫は、Windows の資格情報マネージャーに登録した名前(別名)で指定します。パスワード本文はエージェントにも記録にも現れません。
- ネットワークへは一切出ません。karuzip-mcp はローカルの標準入出力(stdio)だけで動作し、ポートを監視することも外部へ通信することもありません。
Karuzip のファイル処理はローカルで行います。利用するオンライン Agent のサービスには指示・ファイル名・ツール結果が送られる場合があり、作業全体がオフラインになるわけではありません。MCP の媒体一括処理へ渡す書庫入力は、構造を検証した単一 ZIP の選択項目に限ります。分割書庫・ZIP64・7z の書庫入力はこの経路では受け付けません。通常の書庫操作の対応形式とは別の制限です。ローカルのファイルやフォルダーも媒体一括処理の入力に使えます。
よくある質問
AI に勝手にファイルを触られませんか?
触れません。書き込み(解凍・圧縮)は、あらかじめ許可した作業フォルダーの中でだけ、内容を一度返してから実行します。範囲の指定が無いときは書き込み機能自体が現れません。操作はすべて処理記録に残ります。
現在公開中の Microsoft Store 版でも使えますか?
使えません。karuzip-mcp は公式サイト版 3.0.0 に同梱されていますが、現在公開中の Microsoft Store 版には含まれません。
どのエージェント(クライアント)で動きますか?
MCP(stdio)に対応したクライアント(Claude Code・Codex CLI・Cursor など)で動作する設計です。公式サイト版 3.0.0 の実バイナリで initialize・tools/list(roots なし 6/あり 21)・二段階確認を通した展開を検証しています。
対応バージョンと入手
karuzip-mcp は公式サイト版 Karuzip 3.0.0 以降に同梱されています。現在公開中の Microsoft Store 版には含まれません。コマンドライン版 karuzip-cli と同じディレクトリに配置され、インストール後に新しく開いたコマンドプロンプトや PowerShell からそのまま呼び出せます。
公式サイト版 3.0.0 インストーラ(14.71 MB)の SHA-256 は EFCE3B330BDF4C62EDA818957F41497B0E2F11F925AD903E8C4216D0485518F0 です(更新履歴と安全性の案内でもご確認いただけます)。