使用说明
mcp压缩
第一个用于数据压缩的MCP服务器。赋予任何AI代理压缩、解压缩、分析和存储数据的能力。
现有10000多台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.4倍 | 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.9倍 | 85.5% |
| CSV数据(5KB) | 8.1 KB | 2.4 KB | 3.4倍 | 70.5% |
每次压缩都是 无损 --解压缩会逐字节返回精确的原始值。
安装
克劳德代码
添加到 ~/.claude/settings.json:
{
"mcpServers": {
"compress": {
"command": "npx",
"args": ["-y", "mcp-compress"]
}
}
}
OpenClaw/任何MCP客户端
npx mcp-compress
通过stdio讲MCP协议。可与任何兼容MCP的AI代理配合使用。
来源
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" }
为什么存在
- 人工智能代理生成并消耗大量文本-API响应、代码、文档、数据
- 上下文窗口很贵。压缩存储=用更少的空间存储更多的数据=更低的成本。
- MCP是AI代理工具的标准协议。10000+台服务器,没有压缩服务器。
- 自动算法选择意味着代理不需要知道任何关于压缩的信息——它只是工作。
运作原理
- 自动算法选择 --对数据进行gzip、brotli和deflate测试,选择最小的结果
- Brotli赢得90%的时间 --专为文本构建,始终比gzip小20-40%
- 压缩键值存储 —
store/retrieve为代理提供持久压缩存储~/.mcp-compress/ - 香农熵分析 —
analyze告诉你压缩是否值得
测试结果
10/10 evals passing:
✓ Initialize returns protocol version
✓ Lists all 7 tools
✓ Compress returns valid base64 and ratio > 1x
✓ Round-trip is lossless
✓ Analyze returns compressibility recommendation
✓ Store and retrieve preserves data
✓ Stats returns valid counts
✓ List shows stored items
✓ Auto picks smallest algorithm
✓ Handles 100KB+ data
许可证
麻省理工学院
