Zip MCP

🚀 ZIP MCP サーバー

English | 中文

ZIP MCP Server は、fastMCP と zip.js に基づいて実装された Model Context Protocol (MCP) の圧縮サーバーです。完全なパラメータ制御による ZIP ファイルの圧縮、解凍、および圧縮ファイルの情報を照会する機能を提供します。

✨ 主な機能

• ファイルとデータの圧縮と解凍をサポート
• 複数のファイルをまとめて圧縮することができます
• 圧縮レベルを制御できます（0 - 9）
• パスワード保護と暗号化強度の設定をサポート
• 圧縮ファイルのメタデータを照会する機能を提供

📦 プロジェクト構造

zip-mcp
├── src
│   ├── index.ts               # アプリケーションのエントリーファイル
│   ├── utils
│   │   └── compression.ts     # 圧縮と解凍の実装ファイル
├── tsconfig.json              # TypeScript の設定ファイル
├── package.json               # npm の設定ファイル
└── README.md                  # プロジェクトドキュメント

📦 インストール

npm を使用して ZIP MCP Server をグローバルにインストールします。

npm install -g zip-mcp

📚 MCP 設定

インストールが完了したら、MCP JSON 設定で ZIP MCP を設定できます。

{
  "mcpServers": {
    "zip-mcp": {
      "command": "zip-mcp",
      "args": []
    }
  }
}

📚 AI クライアントの MCP JSON 設定

• Claude Client の場合は、https://modelcontextprotocol.io/quickstart/user を参照してください。
• Raycast の場合は、MCP プラグインをインストールする必要があります。
• Cursor の場合は、https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers を参照してください。

📚 MCP ツールの説明

ZIP MCP Server は、MCP プロトコルを介して呼び出すことができる以下のツールを提供します。

圧縮ツール（compress）

ローカルのファイルまたはディレクトリを ZIP ファイルに圧縮します。 パラメータ：

• input: 圧縮するファイルまたはディレクトリのパス（文字列または文字列の配列）
• output: 出力する ZIP ファイルのパス
• options: 圧縮オプション（オプション）
  • level: 圧縮レベル（0 - 9、デフォルトは 5）
  • password: パスワード保護
  • encryptionStrength: 暗号化強度（1 - 3）
  • overwrite: 既存のファイルを上書きするかどうか（ブール値）

戻り値：

• 成功: 成功メッセージを含むテキスト内容
• 失敗: エラーメッセージを含むテキスト内容

解凍ツール（decompress）

ローカルの ZIP ファイルを指定されたディレクトリに解凍します。 パラメータ：

• input: 解凍する ZIP ファイルのパス
• output: 解凍先のディレクトリのパス
• options: 解凍オプション（オプション）
  • password: 解凍パスワード
  • overwrite: 既存のファイルを上書きするかどうか（ブール値）
  • createDirectories: サブディレクトリを作成するかどうか（ブール値）

戻り値：

• 成功: 成功メッセージを含むテキスト内容
• 失敗: エラーメッセージを含むテキスト内容

照会ツール（query）

圧縮ファイル内のファイルリストを照会します。 パラメータ：

• input: 照会する ZIP ファイルのパス
• options: 照会オプション（オプション）
  • password: 復号化パスワード（復号化が必要な場合）

戻り値：

• 成功: ファイルリストを含むテキスト内容
• 失敗: エラーメッセージを含むテキスト内容

💻 使用例

// 圧縮の例
await client.executeTool("zip-mcp/compress", {
  input: ["./files/to_compress/*"],
  output: "./compressed.zip",
  options: {
    level: 9,
    password: "yourpassword"
  }
});

// 解凍の例
await client.executeTool("zip-mcp/decompress", {
  input: "./compressed.zip",
  output: "./extracted_files",
  options: {
    password: "yourpassword"
  }
});

// 照会の例
await client.executeTool("zip-mcp/query", {
  input: "./compressed.zip",
  options: {
    password: "yourpassword"
  }
});

📞 連絡先

• メール: gz7gugu@qq.com
• ブログ: https://7gugu.com