数据压缩服务器

MCP-compress是一款基于Node.js的无损数据压缩服务器,为AI代理提供数据压缩、解压、分析和存储功能,支持多种数据格式并自动选择最佳压缩算法。

  • by ShipItAndPray
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ShipItAndPray/mcp-compress

使用说明

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+台服务器,没有压缩服务器。
  • 自动算法选择意味着代理不需要知道任何关于压缩的信息——它只是工作。

运作原理

  1. 自动算法选择 --对数据进行gzip、brotli和deflate测试,选择最小的结果
  2. Brotli赢得90%的时间 --专为文本构建,始终比gzip小20-40%
  3. 压缩键值存储 — store/retrieve 为代理提供持久压缩存储 ~/.mcp-compress/
  4. 香农熵分析 — 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

许可证

麻省理工学院