convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
ShipItAndPray

MCP Compress

ShipItAndPray/mcp-compress

Compressão lossless inteligente para agentes IA com auto-seleção de algoritmo

Ver no GitHub
InicialPluginScore · de 0 a 100

Primeiro servidor MCP dedicado a compressão de dados com suporte a múltiplos algoritmos (gzip, brotli, deflate). Oferece compressão lossless de até 60x em documentos, armazenamento comprimido em chave-valor e análise automática de compressibilidade. Zero dependências, puro Node.js.

Instalação

$npx convez-ai ShipItAndPray/mcp-compress

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Reduzir tamanho de respostas API antes de armazenar em contexto
  • Comprimir logs, documentos e arquivos SQL para economia de espaço
  • Armazenar dados comprimidos com recuperação lossless
  • Analisar compressibilidade de dados antes de processar

Veredito

Ferramenta prática e bem implementada que preenche um vazio real no ecossistema MCP. Os benchmarks são convincentes (60x em docs) e a auto-seleção de algoritmo elimina complexidade. Útil para qualquer agente que precise gerenciar grandes volumes de dados com restrição de contexto.

README

A tradução para o português deste README ainda está na fila.

mcp-compress

The first MCP server for data compression. Gives any AI agent the ability to compress, decompress, analyze, and store data.

10,000+ MCP servers exist. Zero for compression. This is the first.

Zero dependencies. Pure Node.js. Lossless round-trip. Auto-picks the best algorithm.

Benchmarks

Real results on real data types:

Data TypeOriginalCompressedRatioSaved
Markdown docs (15KB)31.2 KB0.5 KB60.7x98.4%
Repeated config (2KB)5.4 KB0.1 KB51.9x98.1%
SQL query results (8KB)18.9 KB0.6 KB30.4x96.7%
Log files (20KB)33.3 KB1.7 KB19.9x95.0%
JSON API response (10KB)26.7 KB2.6 KB10.2x90.2%
Time-series prices (4KB)20.5 KB3.0 KB6.9x85.5%
CSV data (5KB)8.1 KB2.4 KB3.4x70.5%

Every compression is lossless — decompress returns the exact original, byte-for-byte.

Install

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "compress": {
      "command": "npx",
      "args": ["-y", "mcp-compress"]
    }
  }
}

OpenClaw / Any MCP Client

npx mcp-compress

Speaks MCP protocol over stdio. Works with any MCP-compatible AI agent.

From Source

git clone https://github.com/ShipItAndPray/mcp-compress.git
cd mcp-compress
node index.js

Tools

7 tools available to any connected agent:

ToolWhat it does
compressCompress text/JSON/CSV. Auto-picks best algorithm (gzip, brotli, deflate). Returns base64 + ratio.
decompressDecompress back to original. Lossless round-trip verified.
analyzeShannon entropy, compressibility rating, all algorithms compared, recommendation.
storeCompress and persist to disk with a key. Compressed key-value store for agents.
retrieveDecompress and return stored data by key.
listList all stored items with sizes and compression ratios.
statsTotal items stored, bytes saved, overall compression ratio.

Usage Examples

Compress a large API response:

compress(data: "<10KB JSON>", algorithm: "auto")
→ { ratio: "10.2x", saved_percent: "90.2%", algorithm: "brotli" }

Analyze before compressing:

analyze(data: "<your data>")
→ { compressibility: "HIGH", best_ratio: "30.4x", recommendation: "compress everything" }

Store data for later retrieval:

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>" }

Check what you've stored:

stats()
→ { stored_items: 14, total_saved_bytes: 284102, overall_ratio: "11.2x" }

Why This Exists

  • AI agents generate and consume massive amounts of text — API responses, code, docs, data
  • Context windows are expensive. Compressed storage = more data in less space = lower cost.
  • MCP is the standard protocol for AI agent tools. 10,000+ servers, none for compression.
  • Auto-algorithm selection means the agent doesn't need to know anything about compression — it just works.

How It Works

  1. Auto-algorithm selection — tests gzip, brotli, and deflate on your data, picks the smallest result
  2. Brotli wins 90% of the time — purpose-built for text, consistently 20-40% smaller than gzip
  3. Compressed key-value store — store/retrieve gives agents persistent compressed storage at ~/.mcp-compress/
  4. Shannon entropy analysis — analyze tells you if compression is even worth it before you do it

Test Results

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

License

MIT

Ver o original no GitHub

Bom para

Relacionados