SuperCompress

السجل الرسمي أدوات المطورين

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'
إعداد 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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو SuperCompress؟

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

كيف أثبّت SuperCompress؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SuperCompress إلى مفتاح API؟

نعم. يتطلب SUPERCOMPRESS_API_KEY، وتضبطها في إعداداته.

هل SuperCompress مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون SuperCompress؟

ينشره Supercompress. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.