Skip to main content
Glama
XHCZ MCP Server

XHCZ MCP Server

by SanhanaYuzu
README.md
# XHCZ MCP Server

把 **XHCZ(.xebz)压缩格式** 接入 MCP(Model Context Protocol),让 Claude Desktop、Cursor、Cline、WorkBuddy 等 AI Agent 直接调用 XHCZ 的打包 / 解包 / 基准测试能力。

- **内核**:XEBZ 2.10(与 [hotpe.org/xebz.html](https://hotpe.org/xebz.html) 在线工具同源实现,零改动,格式互通)
- **算法**:14 档 —— XHCZ2→XHCZ8、SpeedSafe、ProSS、Optima、Combo;默认 `x8auto` 自动择优,不可压数据自动 store 兜底,**永不劣于原文**
- **加密**:XHC-Combo2(Argon2id 32MB + ChaCha20-Poly1305)/ XHC-Combo3(Argon2id 64MB + ChaCha20 + AES-256 双层 512-bit)
- **依赖**:零强依赖(纯 Node 内置);`hash-wasm` 为可选依赖,仅加密档位需要
- **测试**:`npm test` —— 10 项自动化用例(含加密回环与错误密码拒绝)

## 安装

```bash
npm i hash-wasm   # 可选:仅使用加密档位时需要
node test.js      # 跑一遍 10 项自检
```

## 接入 MCP 客户端

通用写法(Claude Desktop / Cursor / Cline / 任何支持 stdio MCP 的客户端):

```json
{
  "mcpServers": {
    "xhcz": {
      "command": "node",
      "args": ["/绝对路径/xhcz-mcp/mcp-server.js"]
    }
  }
}
```

## 工具清单

| 工具 | 功能 | 关键参数 |
|---|---|---|
| `xhcz_pack` | 打包文件/目录为 .xebz | `paths[]`、`output`、`algorithm`(默认 x8auto)、`password?`、`kdf?`(combo2/combo3) |
| `xhcz_unpack` | 解压到目录,CRC32 校验 + 防路径穿越 | `archive`、`outputDir`、`password?` |
| `xhcz_info` | 查看格式版本、加密方式、内含文件清单 | `archive`、`password?` |
| `xhcz_algorithms` | 列出 14 档算法与两个加密内核 | — |
| `xhcz_benchmark` | 对指定文件实测多档压缩率与耗时并排名 | `path`、`algorithms?`、`maxBytes?`(默认 32MB) |

## 人类 CLI 模式(附带)

```bash
node mcp-server.js pack out.xebz file1.txt file2.json   # 打包
node mcp-server.js unpack out.xebz ./dest/              # 解压
node mcp-server.js info out.xebz                        # 查信息
node mcp-server.js bench somefile.dat                   # 跑 9 档基准
```

## 版本

| 日期 | 版本 | 说明 |
|---|---|---|
| 2026-11-18 | 1.0.0 | 首发:5 工具 + stdio MCP + Combo2/3 加密 + 基准工具;内核 XEBZ 2.10 未改动 |