ZIP MCP サーバー

中国語|英語

プロジェクト紹介

ZIP MCP Serverは、fastMCPとzip.jsをベースにした圧縮サーバーで、モデルコンテキストプロトコル（MCP）を実装しています。このプロジェクトは、完全にパラメータ制御されたZIP圧縮、解凍、およびクエリ圧縮パッケージ情報機能を提供します。

Related MCP server: ZIP MCP

特徴

• ファイルとデータの圧縮と解凍をサポート

• 複数ファイルのパッケージ圧縮をサポート

• 圧縮レベル制御（0～9）を提供します

• パスワード保護と暗号化強度の設定をサポート

• 圧縮パッケージのメタデータのクエリ機能を提供します

プロジェクト構造

zip-mcp
├── src
│   ├── index.ts               # Application entry point
│   ├── utils
│   │   └── compression.ts     # Compression and decompression implementation
├── tsconfig.json              # TypeScript configuration file
├── package.json               # npm configuration file
└── README.md                  # Project documentation

インストール

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

npm install -g zip-mcp

MCP構成

インストール後、MCP JSON 構成で ZIP MCP を構成できます。

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

AIクライアントでMCP JSONを構成する

• クロード クライアント: https://modelcontextprotocol.io/quickstart/user

• Raycast: MCPプラグインのインストールが必要です

• カーソル: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCPツールの説明

ZIP MCP サーバーは、MCP プロトコルを通じて呼び出すことができる次のツールを提供します。

圧縮ツール（compress）

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

パラメータ:

• input : 圧縮するファイルまたはディレクトリのパス（文字列または文字列配列）

• output : 出力ZIPファイルのパス

• options : 圧縮オプション（オプション）

  • level : 圧縮レベル（0～9、デフォルトは5）

  • password : パスワード保護

  • encryptionStrength : 暗号化強度 (1-3)

  • overwrite : 既存のファイルを上書きするかどうか（ブール値）

戻り値:

• 成功: 成功情報を含むテキストコンテンツ

• 失敗: エラー情報を含むテキストコンテンツ

解凍ツール（解凍）

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

パラメータ:

• input : ZIPファイルのパス

• output : 出力ディレクトリのパス

• options : 解凍オプション（オプション）

  • password ：解凍パスワード

  • overwrite : 既存のファイルを上書きするかどうか（ブール値）

  • createDirectories : 存在しないディレクトリを作成するかどうか（ブール値）

戻り値:

• 成功: 解凍結果情報を含むテキストコンテンツ

• 失敗: エラー情報を含むテキストコンテンツ

ZIP情報ツール（getZipInfo）

ローカル ZIP ファイルのメタデータ情報を取得します。

パラメータ:

• input : ZIPファイルのパス

• options : オプション（オプション）

  • password ：解凍パスワード

戻り値:

• 成功: ZIP ファイルの詳細情報を含むテキスト コンテンツ:

  • ファイルの総数

  • 合計サイズ

  • 圧縮サイズ

  • 圧縮比

  • 各ファイルの詳細情報

• 失敗: エラー情報を含むテキストコンテンツ

テストツール（エコー）

サービスが正常に実行されているかどうかをテストするための入力メッセージを返します。

パラメータ:

• message : 返されるメッセージ

戻り値:

• 入力メッセージと現在のタイムスタンプを含むテキストコンテンツ

例

MCP クライアントを使用してツールを呼び出す例:

// Compress files
await client.executeTool("compress", {
  input: "/path/to/files/or/directory",
  output: "/path/to/output.zip",
  options: {
    level: 9,
    comment: "Test compression",
    password: "secret",
    overwrite: true,
  },
});

// Decompress files
await client.executeTool("decompress", {
  input: "/path/to/archive.zip",
  output: "/path/to/extract/directory",
  options: {
    password: "secret",
    overwrite: true,
    createDirectories: true,
  },
});

// Get ZIP info
await client.executeTool("getZipInfo", {
  input: "/path/to/archive.zip",
  options: {
    password: "secret",
  },
});

// Test service
await client.executeTool("echo", {
  message: "Hello, ZIP MCP Server!",
});

接触

• メールアドレス: gz7gugu@qq.com

• ブログ: https://7gugu.com