ZIP MCP 서버

중국어 | 영어

프로젝트 소개

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

Related MCP server: ZIP MCP

특징

• 파일 및 데이터의 압축 및 압축 해제를 지원합니다.

• 다중 파일 패키징 압축 지원

• 압축 수준 제어(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!",
});

연락하다

• 이메일: gz7gugu@qq.com

• 블로그: https://7gugu.com