SuperCompress

Registre officiel Outils de développement

Compress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "supercompress": {
            "type": "http",
            "url": "https://api.supercompress.dev/api/mcp"
        }
    }
}
NPM package supercompress-proxy
Claude Code
claude mcp add supercompress -e 'SUPERCOMPRESS_API_KEY=<your supercompress_api_key>' -- npx -y supercompress-proxy@0.5.38 supercompress-mcp
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "supercompress": {
            "command": "npx",
            "args": [
                "-y",
                "supercompress-proxy@0.5.38",
                "supercompress-mcp"
            ],
            "env": {
                "SUPERCOMPRESS_API_KEY": "<your supercompress_api_key>"
            }
        }
    }
}

Variables d'environnement

  • SUPERCOMPRESS_API_KEY secret Optional API key (sc_…). Prefer OAuth / device-link via `supercompress setup` if unset.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. SuperCompress v2
  2. Why it exists
  3. Product
  4. Benchmarks & stats
  5. Try it
  6. How it compares

SuperCompress v2

Query-aware context compression for AI applications and coding agents.

Cut coding-agent context ~64% in our B5 benchmark.

~400M Neural Keep on the hosted API · coding-agent plugin via MCP

Open weights (MIT) on Hugging Face

64.1% mean context cut on B5 (24 coding-agent cases) · 24/24 evidence passes · up to 96.6% @ ≥99% retention

(B5 coding-agent suite · evidence containment metric — not downstream LLM completion)

Get API key · Arena · Install · Benchmarks · Docs

vs Headroom · vs RTK · vs LLMLingua


Why it exists

Every LLM call ships a pile of context: RAG chunks, chat history, tool dumps, logs, JSON. Most of it is irrelevant to the current question — but the model still reads it, and you still pay for it.

Usual “fix”What actually happens
TruncateDeletes the middle. The answer is often in the middle.
SummarizeRewrites evidence. IDs, stack traces, and exact errors get soft.
HopeShip the full dump. Watch the bill climb.

SuperCompress v2 compresses context against the query. It keeps answer-critical lines in their original wording and drops the rest — on our coding-agent benchmark (B5), 64.1% mean context reduction with 24/24 evidence-retention passes.


Product

SuperCompress is a compression layer in front of inference:

  1. Takes a long context + the current query
  2. Segments and scores blocks by relevance to that query
  3. Keeps entities, errors, definitions, nearby dependencies
  4. Returns a smaller prompt + token stats

The query is never compressed — only the surrounding context.

Two paths
Neural v2 (recommended)Compiler (fast/local)
Engine~400M query-aware cross-encoderLightweight local policy
RuntimeHosted Fly CPU (Neural Keep)Local CPU · millisecond-class
Best forHighest-quality keep on agent dumpsLocal preprocessing / speed
BenchmarksLaunch / B5Legacy section
Two products
Coding-agent pluginAPI / Python
ForCursor, Claude Code, Codex, and 40+ agent harnessesApps, RAG, agents, backends
Installnpm i -g supercompress-proxy && npx supercompress setuppip install supercompress
What you getMCP compress_context on big dumpsCompress before every model call
LoginKeep your normal agent loginAPI key from the dashboard

Docs: coding agents (first 5 minutes checklist) · API quickstart

Repo map
PathWhat
packages/proxyCoding-agent plugin (npm)
api/Hosted API + billing
web/Site + docs HTML
supercompress/Python package
docs/REPO_LAYOUT.mdWhat belongs in OSS vs private

Private marketing, outreach, and model training stay out of this repo (see .gitignore + docs/REPO_LAYOUT.md).


Benchmarks & stats

We measure whether required evidence survives (containment), not downstream LLM completion.

Neural v2 launch (hosted ~400M) — B5 coding-agent suite
MetricResult
Mean context cut64.1%
Evidence passes24 / 24
Tokens16,647 → 5,148
Max cut @ ≥99% retention96.6%
B5 latency p50~5.8 s (hosted Neural Keep on Fly CPU)
Public cases (full suite)390
Downstream LLM evalNot yet run

Aggregate mean cut across all 390 cases is ~3.6% — the engine often refuses to over-cut dense needle/QA slices. The 64.1% figure is the coding-agent suite where dumps are noisy.

Raw JSON: launch-benchmark.json · writeup: benchmarks

Legacy compiler (separate product)

CPU / millisecond-class local path. Older held-out compiler numbers (≈58–66% cut, 99.4% gold containment) live under Legacy/compiler on /benchmarks. Do not mix with Neural v2.


Try it

npm install -g supercompress-proxy
npx supercompress setup

Links your account, detects agents, installs MCP. Docs: coding agents

Python / HTTP
pip install supercompress
export SUPERCOMPRESS_API_KEY=sc_live_YOUR_KEY
from supercompress.client import SuperCompress

sc = SuperCompress()
result = sc.compress(
    context=long_context,
    query="What failed and how do we fix it?",
)
print(f"{result.original_tokens} → {result.kept_tokens} tokens")
print(result.compressed_text)
curl -X POST https://www.supercompress.dev/api/v1/compress \
  -H "X-API-Key: $SUPERCOMPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"context":"...","query":"What failed?"}'

Or paste a dump into the Arena — no integration required.


How it compares

TruncateSummarizeSuperCompress
Cuts tokens✓✓✓
Uses the query✗weak✓
Keeps original evidencesometimes✗✓
Auditable kept linespartial✗✓

More: vs truncation · vs summarization · vs alternatives


supercompress.dev · MIT License · Sponsor · built by Arjun Shah

Questions fréquentes

Qu'est-ce que SuperCompress ?

Compress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.

Comment installer SuperCompress ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour SuperCompress ?

Oui. Il attend SUPERCOMPRESS_API_KEY, à renseigner dans sa configuration.

SuperCompress est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient SuperCompress ?

Il est publié par Supercompress. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.