AI导哈

ZIP压缩解压工具服务器

MCP ZIP Server是一款支持ZIP压缩、解压及存档检查的AI代理工具服务器，适用于本地和远程部署。

  • by DragonSupremeAI
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DragonSupremeAI/mcp-zip

使用说明

MCP ZIP服务器

MCP ZIP服务器 是一个 模型上下文协议（MCP）工具服务器 它为AI代理提供ZIP压缩、解压缩和存档检查。

它旨在同时工作：

  • 本地地 （通过MCP stdio，例如光标、克劳德桌面）

  • 远程地 （通过HTTP，例如拥抱面部聊天MCP工具）

服务器支持 安全内存base64工具 对于托管环境和 基于文件系统的工具 供当地使用。

MCP压缩包为：

  • 无头MCP工具服务器

  • 适用于拥抱面部聊天MCP工具

  • 适用于基于Docker的部署

  • 无状态且对模特友好

特性

  • ZIP压缩和解压缩

  • 多文件和目录支持

  • 压缩级别控制（0-9）

  • 密码保护的存档

  • ZIP元数据检查

  • 始终使用HTTP传输 （适用于托管MCP）

  • stdio传输 （适用于本地MCP客户）

  • Base64工具 用于安全的远程操作（不需要文件系统访问）

运输

MCP ZIP服务器支持 两次运输同时进行:

1.MCP标准（本地）

使用人：

  • 光标

  • 克劳德桌面版

  • 光线投射MCP

2.HTTP（远程）

使用人：

  • 拥抱面部聊天MCP工具

  • 托管代理

  • Docker/Kubernetes部署

HTTP服务器 始终默认启动.

HTTP服务器行为

启动时，服务器：

  1. 重新启动MCP stdio

  2. 在可配置端口上启动HTTP服务器

端口选择（按顺序）：

  1. PORT （拥抱面部空间标准）

  2. MCP_HTTP_PORT

  3. HTTP_PORT

  4. 退路： 3000

HTTP端点

端点 方法 描述
/health GET 服务器名称、版本、工具列表
/tools GET 已注册工具列表
/invoke/<tool> POST 使用JSON参数调用工具

拥抱面部空间（Docker）设置

这是 推荐方式 托管MCP服务器，用于拥抱面部聊天。

1.创建Docker空间

  • 首选 拥抱脸→ 空间

  • 点击 新空间

  • 选择 码头工人

  • 选择您的回购分支机构（例如。 hfdocker)

2.最小化的Dockerfile

FROM node:20-slim

WORKDIR /app

COPY package.json package-lock.json* ./
RUN npm install --omit=dev

COPY . .

RUN npm run build

ENV NODE_ENV=production
ENV PORT=7860

EXPOSE 7860

CMD ["node", "dist/index.js"]

拥抱面部自动注射 PORT.

3.空间设置

在 太空→ 设置:

  • 无需保密

  • 无需GPU

  • 可见性：公共或私人

4.验证空间

运行后，打开：

https://<your-space>.hf.space/health

预期响应：

{
  "name": "MCP ZIP Server",
  "version": "1.0.x",
  "tools": ["compress", "decompress", "getZipInfo", "compressBytes", ...]
}

5.添加到拥抱面部聊天MCP工具

  1. 打开 拥抱式面部聊天

  2. 首选 MCP工具

  3. 点击 添加服务器

  4. 输入：

    • 姓名： MCP拉链

    • 网址： https://<your-space>.hf.space

  5. 保存

ZIP工具现在可用于模型。

本地MCP设置（光标/克劳德桌面）

全局安装：

npm install -g mcp-zip

添加到MCP配置：

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

工具概述

文件系统工具（仅限本地）

  • compress

  • decompress

  • getZipInfo

这些在本地路径上运行，用于 仅限本地MCP客户端.

Base64工具（可安全托管使用）

这些是 推荐用于拥抱面部聊天.

compressBytes

压缩内存中的文件。

{
  "files": [
    { "name": "a.txt", "dataBase64": "aGVsbG8=" }
  ]
}

返回：base64 ZIP压缩文件。

decompressBytes

解压缩base64 ZIP存档。

{
  "zipDataBase64": "UEsDB..."
}

返回值：数组 { name, dataBase64 }.

getZipInfoBytes

检查base64 ZIP存档。

{
  "zipDataBase64": "UEsDB..."
}

返回：JSON元数据。

安全注意事项

  • 托管部署应 更喜欢base64工具

  • 文件系统工具不应暴露给不受信任的用户

  • 建议在平台级别设置ZIP炸弹防护和尺寸限制

版本控制

  • HTTP+base64支持： >=1.0.3

相关 MCP