SuperCompress

io.github.Supercompressv0.5.38更新于 Oct 3, 2026

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

已验证Streamable HTTP可网页运行Developer ToolsAI & MLProductivity & Workflow

概览

AI 生成的概览

针对当前问题压缩庞大的编码代理上下文，以减少 LLM 输入 token，并通过 MCP 提供压缩、账户关联和用量工具。

功能
SuperCompress 会针对当前问题对文件、日志、工具输出和粘贴内容等庞大上下文进行评分，丢弃填充内容，同时保留对证据关键的原始行。它提供 compress_context、connect_account 和 usage_summary 等 MCP 工具，并可向多种编码工具安装 hooks 和 MCP 配置。可选的本地代理可为兼容 OpenAI 和 Anthropic 的客户端重写 base URL。
适用场景
当编码代理经常发送大文件、日志或工具输出，而你希望在不丢失关键答案内容的前提下减少输入 token 时，值得添加。它适用于支持 MCP 或 hooks 的 Cursor、Claude Code、Codex 等工具。
运行要求
需要 Node.js 18+ 以运行 npm 包 supercompress-proxy，可通过 npx 或全局安装。需通过 setup 命令或 OAuth/设备关联绑定 SuperCompress 账户；可选 API 密钥通过 SUPERCOMPRESS_API_KEY 传入。需要访问 SuperCompress API 的网络连接，可选本地代理监听 localhost:8080。
安装前请注意
上下文文本会发送到 SuperCompress API 进行托管压缩，因此不要通过它发送机密或受监管数据。服务按量计费：每月有免费 token 额度，超出后计费，可用 usage_summary 查看配额。setup 命令会为检测到的代理写入 MCP 和 hook 配置，uninstall 会删除用户主目录下的文件。请将 SUPERCOMPRESS_API_KEY 视为机密。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SuperCompress，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "supercompress": {
      "type": "http",
      "url": "https://api.supercompress.dev/api/mcp"
    }
  }
}

README

SuperCompress

SuperCompress v2 — cut ~64% of LLM input tokens for coding agents, without losing the answer.

~400M Neural Keep on the SuperCompress API scores bulky context (files, logs, tool dumps, pastes) against the current question and drops the rest. Your ask stays intact. This package wires Cursor / Claude Code / Codex / 60+ harnesses into that API via MCP + hooks.

Website · Benchmarks · Playground · Docs

Install

bash
npm install -g supercompress-proxy

Requires Node.js 18+.

Quick start (recommended)

One command links your account and auto-adds MCP + hooks across 60+ harnesses (25+ get a native auto MCP plugin — Cursor, Claude Code, Codex, Goose, Zed, OpenCode, fx, Hermes, OpenClaw, Grok, Gemini, Windsurf, Continue, and more):

bash
supercompress setupsupercompress doctor

Then restart your agent so integrations reload. That’s it.

Re-detect later (new agent installed, etc.):

bash
supercompress pluginsupercompress agentssupercompress doctor

Any other agent (custom harness, closed-source, DIY):

bash
supercompress agents connect

That prints a stdio MCP snippet and writes an Agent Plugins 1.0 pack you can drop into any compatible client.

Benchmarks

Same keep-budget (35% of tokens kept). Who still has the answer?

MethodAnswer-critical kept
FIFO / truncation24.8%
Summarization60.5%
H2O97.9%
SuperCompress100%
MetricResult
Oracle recall (fixed budget)100%
Mean token cut (real suite)~67%
Important lines kept (compiler)100%

Full methodology and charts: supercompress.dev/benchmarks

How it works

Your agent ──→ SuperCompress (hooks / MCP) ──→ smaller context ──→ model                      ↑                 query stays whole; only context is compressed
  1. You ask a question (never rewritten).
  2. Large context is scored against that question.
  3. Evidence-critical lines stay in original wording; filler drops.
  4. You pay for fewer input tokens.

Commands

CommandWhat it does
supercompress / tuiInteractive paper-branded UI (default in a TTY; Bun)
supercompress setupRecommended — link account, detect agents, install MCP + hooks
supercompress pluginRefresh agent integrations anytime
supercompress doctorPer-harness health matrix (account / MCP / hooks)
supercompress agents60+ catalog — auto-plugin vs recipe/connect
supercompress start / stop / statusOptional local proxy (setup --proxy)
supercompress usagePlan, quota, savings (--json ok)
supercompress uninstallRemove configs under ~/.supercompress

Optional localhost API proxy (base-URL rewrite) if you explicitly need it:

bash
supercompress setup --proxysupercompress start

Then point OpenAI/Anthropic-compatible clients at http://localhost:8080/v1.

MCP

setup / plugin registers the MCP server on every detected host. You can also run it directly:

bash
supercompress-mcp

Manual registration:

json
{  "mcpServers": {    "supercompress": {      "command": "supercompress-mcp"    }  }}
ToolPurpose
compress_contextCompress bulky context for a query
connect_accountLink this install to your dashboard
usage_summarySavings for the connected account

Account & pricing

Launch promo: 5M tokens/month free, then $0.10 / 1M from the dashboard.

Privacy

Hooks / MCP run on your machine. Provider API keys stay with your agent. Context text is sent to the SuperCompress API so the hosted compiler can compress it.

More

License

MIT — see LICENSE.

来源：packages/proxy/README.md，提交 08a34db

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.5.38最新Oct 3, 2026