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.

Related MCP server: MCP Claude Code

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

Cliente Claude: https://modelcontextprotocol.io/quickstart/user
Raycast: requiere instalar el complemento MCP
Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

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!", });