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

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

端口选择（按顺序）：

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

1. MCP_HTTP_PORT

1. HTTP_PORT

1. 退路： 3000

______________________________________________________________________

HTTP端点

______________________________________________________________________

拥抱面部空间（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://.hf.space/health

预期响应：

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

______________________________________________________________________

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

1. 打开 拥抱式面部聊天

1. 首选 MCP工具

1. 点击 添加服务器

1. 输入：

- 姓名： MCP拉链

- 网址： https://.hf.space

1. 保存

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