内容
# mcp-compress
首个用于数据压缩的MCP服务器。赋予任何AI代理压缩、解压、分析和存储数据的能力。
**10,000+ MCP服务器存在。零用于压缩。这是第一个。**
零依赖。纯Node.js。无损往返。自动选择最佳算法。
## 基准测试
真实数据类型的真实结果：
| 数据类型 | 原始大小 | 压缩大小 | 压缩比 | 节省比例 |
|-----------|----------|------------|-------|-------|
| Markdown文档（15KB） | 31.2 KB | 0.5 KB | **60.7x** | 98.4% |
| 重复配置（2KB） | 5.4 KB | 0.1 KB | **51.9x** | 98.1% |
| SQL查询结果（8KB） | 18.9 KB | 0.6 KB | **30.4x** | 96.7% |
| 日志文件（20KB） | 33.3 KB | 1.7 KB | **19.9x** | 95.0% |
| JSON API响应（10KB） | 26.7 KB | 2.6 KB | **10.2x** | 90.2% |
| 时间序列价格（4KB） | 20.5 KB | 3.0 KB | **6.9x** | 85.5% |
| CSV数据（5KB） | 8.1 KB | 2.4 KB | **3.4x** | 70.5% |
每次压缩都是**无损**的——解压后返回原始数据，字节级别完全一致。
## 安装
### Claude 代码
添加到 `~/.claude/settings.json`：
```json
{
"mcpServers": {
"compress": {
"command": "npx",
"args": ["-y", "mcp-compress"]
}
}
}
```
### OpenClaw / 任意MCP客户端
```bash
npx mcp-compress
```
通过标准输入/输出与MCP协议通信。与任何兼容MCP的AI代理一起工作。
### 从源码
```bash
git clone https://github.com/ShipItAndPray/mcp-compress.git
cd mcp-compress
node index.js
```
## 工具
7种工具可供任意连接的代理使用：
| 工具 | 功能 |
|------|-------------|
| `compress` | 压缩文本/JSON/CSV。自动选择最佳算法（gzip、brotli、deflate）。返回base64 + 压缩比。 |
| `decompress` | 解压回原始数据。无损往返验证。 |
| `analyze` | 香农熵、压缩率、所有算法比较、推荐。 |
| `store` | 压缩并持久化到磁盘，带有一个键。压缩的键值存储，供代理使用。 |
| `retrieve` | 解压并通过键返回存储的数据。 |
| `list` | 列出所有存储的项目，带大小和压缩比。 |
| `stats` | 存储的项目总数、节省的字节数、整体压缩比。 |
## 使用示例
**压缩大型API响应：**
```
compress(data: "<10KB JSON>", algorithm: "auto")
→ { ratio: "10.2x", saved_percent: "90.2%", algorithm: "brotli" }
```
**压缩前分析：**
```
analyze(data: "<your data>")
→ { compressibility: "HIGH", best_ratio: "30.4x", recommendation: "compress everything" }
```
**存储数据以便后续检索：**
```
store(data: "<research notes>", name: "market-analysis")
→ { key: "market-analysis", ratio: "8.3x", saved: "12,450 bytes" }
retrieve(key: "market-analysis")
→ { data: "<original research notes>" }
```
**查看已存储的数据：**
```
stats()
→ { stored_items: 14, total_saved_bytes: 284102, overall_ratio: "11.2x" }
```
## 为什么存在
- AI代理生成和消耗大量文本——API响应、代码、文档、数据
- 上下文窗口很昂贵。压缩存储 = 更多数据占用更少空间 = 更低成本。
- MCP是AI代理工具的标准协议。10,000+服务器，没有一个用于压缩。
- 自动算法选择意味着代理不需要了解压缩——它直接工作。
## 工作原理
1. **自动算法选择** — 在数据上测试gzip、brotli和deflate，选择最小的结果
2. **brotli 90%的时间获胜** — 专门为文本构建，比gzip小20-40%
3. **压缩键值存储** — `store`/`retrieve`为代理提供持久的压缩存储在`~/.mcp-compress/`
4. **香农熵分析** — `analyze`告诉你是否值得压缩
## 测试结果
```
10/10 评估通过：
✓ 初始化返回协议版本
✓ 列出所有7种工具
✓ 压缩返回有效的base64和压缩比 > 1x
✓ 往返无损
✓ 分析返回压缩推荐
✓ 存储和检索保留数据
✓ 统计返回有效计数
✓ 列表显示存储的项目
✓ 自动选择最小算法
✓ 处理100KB+数据
```
## 许可证
MIT
