ZIP-MCP

by 7gugu
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides ZIP compression and decompression functionality within Raycast through the MCP plugin, supporting file compression with customizable settings, extraction of archives, and inspection of ZIP file contents.

Servidor ZIP MCP

Chino | Inglés

Introducción del proyecto

El servidor ZIP MCP es un servidor de compresión basado en fastMCP y zip.js, que implementa el Protocolo de Contexto de Modelo (MCP). Este proyecto proporciona funciones de compresión, descompresión y consulta de información de paquetes ZIP totalmente controladas por parámetros.

Características

  • Admite compresión y descompresión de archivos y datos.
  • Admite compresión de paquetes de múltiples archivos
  • Proporciona control del nivel de compresión (0-9)
  • Admite protección con contraseña y configuraciones de fortaleza de cifrado
  • Proporciona una función de consulta para metadatos de paquetes comprimidos

Estructura del proyecto

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

Instalación

Puede instalar ZIP MCP Server globalmente usando npm:

npm install -g zip-mcp

Configuración de MCP

Después de la instalación, puede configurar ZIP MCP en su configuración JSON de MCP:

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

Configurar el JSON de MCP en el cliente de IA

Descripción de la herramienta MCP

El servidor ZIP MCP proporciona las siguientes herramientas, que se pueden llamar a través del protocolo MCP:

Herramienta de compresión (comprimir)

Comprime archivos o directorios locales en un archivo ZIP.

Parámetros:

  • input : Ruta del archivo o directorio que se va a comprimir (cadena o matriz de cadenas)
  • output : Ruta del archivo ZIP de salida
  • options : Opciones de compresión (opcional)
    • level : Nivel de compresión (0-9, el valor predeterminado es 5)
    • password : Protección con contraseña
    • encryptionStrength : Fuerza de cifrado (1-3)
    • overwrite : si se deben sobrescribir los archivos existentes (booleano)

Devoluciones:

  • Éxito: Contenido de texto que contiene información de éxito
  • Error: Contenido de texto que contiene información de error

Herramienta de descompresión (descomprimir)

Descomprime los archivos ZIP locales en el directorio especificado.

Parámetros:

  • input : Ruta del archivo ZIP
  • output : Ruta del directorio de salida
  • options : Opciones de descompresión (opcional)
    • password : Contraseña de descompresión
    • overwrite : si se deben sobrescribir los archivos existentes (booleano)
    • createDirectories : Si se deben crear directorios inexistentes (booleano)

Devoluciones:

  • Éxito: Contenido de texto que contiene información del resultado de la descompresión
  • Error: Contenido de texto que contiene información de error

Herramienta de información ZIP (getZipInfo)

Obtener información de metadatos de archivos ZIP locales.

Parámetros:

  • input : Ruta del archivo ZIP
  • options : Opciones (opcionales)
    • password : Contraseña de descompresión

Devoluciones:

  • Éxito: Contenido de texto que contiene información detallada del archivo ZIP, incluyendo:
    • Número total de archivos
    • Tamaño total
    • Tamaño comprimido
    • Relación de compresión
    • Información detallada de cada archivo
  • Error: Contenido de texto que contiene información de error

Herramienta de prueba (eco)

Devuelve el mensaje de entrada para probar si el servicio se está ejecutando normalmente.

Parámetros:

  • message : Mensaje a devolver

Devoluciones:

  • Contenido de texto que contiene el mensaje de entrada y la marca de tiempo actual

Ejemplos

Ejemplos de herramientas de llamada utilizando el cliente 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!", });

Contacto

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Una herramienta MCP que proporciona a la IA la capacidad de comprimir y descomprimir archivos locales.

  1. Project Introduction
    1. Features
      1. Project Structure
        1. Installation
          1. MCP Configuration
            1. Configure the MCP JSON in the AI Client
              1. MCP Tool Description
                1. Compression Tool (compress)
                2. Decompression Tool (decompress)
                3. ZIP Info Tool (getZipInfo)
                4. Test Tool (echo)
              2. Examples
                1. Contact
                  ID: r2o0kmsyni