ZIP MCP 서버

프로젝트 소개

ZIP MCP 서버는 fastMCP와 zip.js를 기반으로 하는 압축 서버로, 모델 컨텍스트 프로토콜(MCP)을 구현합니다. 이 프로젝트는 매개변수 제어 방식의 ZIP 압축, 압축 해제, 그리고 쿼리 압축 패키지 정보 기능을 제공합니다.

Related MCP server: MCP Claude Code

특징

파일 및 데이터의 압축 및 압축 해제를 지원합니다.
다중 파일 패키징 압축 지원
압축 수준 제어(0~9) 제공
암호 보호 및 암호화 강도 설정을 지원합니다.
압축된 패키지 메타데이터에 대한 쿼리 기능을 제공합니다.

프로젝트 구조

지엑스피1

설치

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
레이캐스트: 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 : 기존 파일을 덮어쓸지 여부(부울)

보고:

성공: 성공 정보가 포함된 텍스트 콘텐츠
실패: 오류 정보가 포함된 텍스트 콘텐츠

압축 해제 도구(decompress)

지정된 디렉토리에 로컬 ZIP 파일의 압축을 풉니다.

매개변수:

input : ZIP 파일의 경로
output : 출력 디렉토리 경로
options : 압축 해제 옵션(선택 사항)
- password : 압축 해제 비밀번호
- overwrite : 기존 파일을 덮어쓸지 여부(부울)
- createDirectories : 존재하지 않는 디렉토리를 생성할지 여부(부울)

보고:

성공: 압축 해제 결과 정보가 포함된 텍스트 콘텐츠
실패: 오류 정보가 포함된 텍스트 콘텐츠

우편번호 정보 도구(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!", });