tare MCP server
2026년 11월 9일 커밋코딩 에이전트를 위해 손실 없는 캐시 안전 및 출력 인지 압축 기술을 사용하여 LLM 컨텍스트 창 사용량을 44–73% 줄여줍니다.
다른 이름 mstuart/tare
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
tare MCP란?
코딩 에이전트를 위해 손실 없는 캐시 안전 및 출력 인지 압축 기술을 사용하여 LLM 컨텍스트 창 사용량을 44–73% 줄여줍니다.
프로젝트 README에서 생성된 요약
tare MCP server 정보
코딩 에이전트를 구축하는 개발자는 tare를 사용하여 컨텍스트 창 사용량을 44%에서 73%까지 줄일 수 있습니다. 이 도구는 에이전트와 모델 API 사이에서 도구 출력, 로그, JSON을 더 밀도 높은 형태로 압축합니다. 기본적으로 손실 없는 방식으로 설계되었으며, AST 코드 스켈레톤화(skeletonization)나 요약된 자연어(telegraphic natural language)와 같은 방식을 명시적으로 선택한 경우에만 정보가 삭제됩니다.
사용자는 에이전트의 base URL을 Anthropic 및 OpenAI 엔드포인트를 지원하는 tare-proxy로 지정하여 로컬 프록시로 배포할 수 있습니다. 또한 compress 및 skeletonize와 같은 하위 명령어를 가진 CLI 또는 Claude Desktop 및 Cursor와 같은 클라이언트를 위한 MCP server로도 사용할 수 있습니다. 이 시스템은 캐시를 인식하여 중단 지점을 감지함으로써 제공업체의 prefix cache가 효과적으로 유지되도록 설계되었으며, 모델의 출력량이 급증하는 것을 감지하면 압축을 완화하는 출력 인지 기능을 갖추고 있습니다.
통합 방식은 유연합니다. stdio를 통해 작동하여 API 키가 필요 없는 tare-mcp server를 사용하거나, 프로세스 내 압축을 위해 Python 및 JavaScript 라이브러리를 사용할 수 있습니다.
활용 사례
- 1대규모 소스 파일 압축개발자는 스켈레톤화(skeletonization)를 사용하여 파일의 구조적 시그니처는 유지하면서 함수 본문만 제거할 수 있습니다.
- 2로그 및 JSON 오버헤드 감소대규모 테이블 데이터나 로그 파일을 축소하여 컨텍스트 창에 더 많은 정보를 담을 수 있습니다.
- 3MCP 클라이언트 통합사용자는 API 키 없이도 모든 MCP 클라이언트에 압축 및 지속성 메모리 기능을 추가할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
TARE_UPSTREAM
| 이름 | 설명 | 유형 |
|---|---|---|
| TARE_UPSTREAM | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능mstuart/tare is public and reachablegithub.com/mstuart/tare ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/mstuart/tare ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기tare sits between your agent and the model API and shrinks the context window. Three properties make it different:
- Lossless by default — tool output, logs, and JSON are re-encoded into a denser equivalent form. Information is dropped only when you opt in (row-caps, telegraphic NL, AST code skeletonization).
- Cache-correct — provider prefix caches discount cached tokens ~10×, and one rewritten byte in the prefix forfeits it. tare detects the cache breakpoint and compresses only the dynamic suffix.
- Output-aware — over-compression makes models compensate with verbose output, so total cost can rise as input falls. tare watches output tokens per turn and backs off when they spike.
What you get
tare-proxy— point your agent's base URL at it; zero code changes. Speaks Anthropic (/v1/messages) and OpenAI (/v1/chat/completions).tareCLI —compress,skeletonize,compact-lossy, and 12 more subcommands (full reference).tare-mcp— compression + persistent cross-session memory as MCP tools, for any MCP client.- Libraries —
tare-core(Rust),tare-compress(Python),tare-ai(JS/TS).
Proof
All numbers are measured by running target/release/tare on the committed corpus with tiktoken
o200k_base (v0.13.0). Results live in crates/tare-bench/results/; reproduce with
python3 crates/tare-bench/run_proof.py.
| Name | Content type | Command | Input tokens | Output tokens | Reduction |
|---|---|---|---|---|---|
| cargo_packages | json_array | tare compact-lossy |
6,906 | 3,625 | 47.5% |
| ps_aux | tabular | tare compact-lossy |
1,545 | 802 | 48.1% |
| app_log | logs | tare compact-lossy |
13,217 | 6,551 | 50.4% |
| agent_context | agent_context | tare compress |
15,130 | 8,499 | 43.8% |
| server_rs | code | tare skeletonize --path server.rs |
5,930 | 1,582 | 73.3% |
| json_crush_rs | code | tare skeletonize --path json_crush.rs |
3,937 | 1,607 | 59.2% |
| readme_prose | prose | tare compact-lossy |
5,732 | 2,727 | 52.4% |
Code reads are ~67–76% of a coding agent's tokens (SWE-Pruner, ACL 2026),
so skeletonization is the biggest lever. Head-to-head harnesses against Headroom, LLMLingua-2,
lean-ctx, and RTK live in crates/tare-bench/benchmarks/.
Compared to
| Scope | Deploy | Local | Lossless default | Output-aware¹ | |
|---|---|---|---|---|---|
| tare | tools · logs · files · JSON · history | proxy · library · CLI · MCP | ✅ | ✅ | ✅ |
| Headroom | all context | proxy · lib · MCP | ✅ | ❌ (reversible via cache) | ❌ |
| RTK | CLI command outputs | CLI wrapper | ✅ | ❌ | ❌ |
| lean-ctx | CLI commands, MCP tools | CLI · MCP | ✅ | ❌ | ❌ |
| LLMLingua-2 | prose / RAG | library (ML model) | ✅ | ❌ | ❌ |
| OpenAI / Anthropic native compaction | conversation history | provider-native | ❌ | ❌ | ❌ |
¹ Output-aware = reads the model's output token count each turn and reduces compression aggression
when verbosity spikes (the x-tare-verbosity-spike signal in
crates/tare-proxy/src/server.rs).
When to use · When to skip
Great fit if you…
- run coding agents and want savings without losing information by default
- care about the provider cache staying warm (tare won't break the prefix)
- want code reads compressed structurally (signatures kept, bodies elidable on demand)
Skip it if you…
- only use a single provider's native compaction and don't need a cross-provider proxy
- run in a sandbox where a local proxy process can't run
Get started (60 seconds)
# 1 — install (no Rust toolchain needed)
curl -fsSL https://raw.githubusercontent.com/mstuart/tare/main/install.sh | sh # → ~/.local/bin
# or: npm install -g tare-ai
# or: docker pull ghcr.io/mstuart/tare
# or: cargo install tare-cli
# or: git clone https://github.com/mstuart/tare && cd tare && cargo build --release
# 2 — run as a proxy (point your agent's base URL at http://localhost:8787)
TARE_UPSTREAM=https://api.anthropic.com tare-proxy
# 3 — or use the CLI on any stdin
cat big.rs | tare skeletonize --path big.rs # drop fn bodies, keep structure
ps aux | tare compact-lossy --max-rows 30 --max-field 110
| Env var | Default | Meaning |
|---|---|---|
TARE_UPSTREAM |
https://api.anthropic.com |
upstream API base URL |
TARE_PORT |
8787 |
listen port |
TARE_RECENCY |
4 |
recent tool outputs always kept |
TARE_ENABLED |
true |
set 0/false for byte-exact passthrough |
TARE_CONTEXT_LIMIT |
200000 |
model context window (drives the fill dial) |
TARE_OUTPUT_HOLDOUT |
0 |
fraction of sessions left uncompressed (A/B for tare output-savings) |
TARE_ADMIN_TOKEN |
unset | secret required by admin endpoints and CLI admin commands; unset disables the admin API |
TARE_LOG |
unset | set it to log one line per turn with the compression report |
Response headers (x-tare-input-tokens, x-tare-net-tokens, x-tare-dropped, x-tare-aggression,
x-tare-verbosity-spike, x-tare-halted) report what each turn did; GET /admin/stats and
POST /admin/runtime-env expose live stats and hot config when TARE_ADMIN_TOKEN is set; clients
must send the token in x-tare-admin-token. Details: getting started.
Integrations
# pip install tare-compress
import tare
out = tare.compress(blocks_json, task="fix the login bug") # in-process, no proxy needed
// npm install tare-ai
import { withTare } from "tare-ai";
const client = new Anthropic(withTare({ apiKey: "..." })); // routes through the local proxy
Python ships all core transforms in-process plus adapters for litellm, ASGI, LangChain, Agno, and Strands; JS/TS ships proxy helpers for the Anthropic/OpenAI SDKs and the Vercel AI SDK. Full adapter reference: docs/integrations.md.
Use with your Claude subscription — MCP, no API key
The proxy forwards whatever auth the client sends — a billable x-api-key, or your Claude Pro/Max
subscription OAuth token when you point Claude Code's ANTHROPIC_BASE_URL at it
(scripts/live-smoke-sub.sh runs exactly this round-trip). Prefer no base-URL change at all? Run
tare-mcp: a local stdio server your agent calls as tools — it never calls the model itself, so it
needs no API key.
# easiest — no build; npx fetches the prebuilt binary on first run:
claude mcp add tare -s user -- npx -y -p tare-ai tare-mcp
{
"mcpServers": {
"tare": { "command": "npx", "args": ["-y", "-p", "tare-ai", "tare-mcp"] }
}
}
Paste the same block into any MCP client (Cursor, Codex, Claude Desktop's
claude_desktop_config.json, …). It exposes 10 tools: compression (tare_compress,
tare_skeletonize, tare_compact_lossy, tare_deref_images), a reversible tare_expand,
tare_stats, and cross-session memory — full list.
Wrap your agent
One command starts the proxy and launches your CLI agent through it — ENV-based and ephemeral:
tare wrap claude # start proxy + launch Claude Code through it
tare wrap codex --port 9000 # 12 agents supported: claude, codex, aider, goose, …
tare wrap claude --print # dry-run: show what would run
Full agent matrix and modes: docs/cli.md.
Status & limitations
- Tested — verified end-to-end against the live Anthropic API (a full proxy round-trip on a
Claude subscription, plus the MCP server over real stdio JSON-RPC), on top of 228 unit,
integration, and property tests;
fmt/clippy -D warnings/cargo denygate every commit. - Deploy it as a local sidecar — tare runs next to your agent and forwards your credentials
upstream without logging or persisting them; treat it as a trusted component on your own machine,
not shared multi-tenant infrastructure (SECURITY.md). Startup failures exit with a
clear
[tare-proxy] fatal: …message, never a panic backtrace.
Known edges
- Proxy and CLI token counts are approximate (
tare-tokenize, chars/4); the benchmark numbers above are measured with tiktoken. - The context-fill signal counts the serialized request (incl. JSON envelope), so it slightly over-estimates fill — conservative, errs toward compressing sooner.
- A
>2 MBstreaming response whose final usage event straddles the 64 KB tail buffer may skip one verbosity sample (non-fatal).
Non-goals — no trained ML text-compressor (no weights to download, no inference latency) and no
audio: transcribe externally and feed the transcript through tare compress.
Architecture
Nine crates: engine (tare-core), proxy + closed-loop controller (tare-proxy), CLI, MCP server,
SQLite memory, tokenizer, cache models, Python bindings, bench harness. Optional neural-embed
feature swaps keyword relevance for exact-cosine neural embeddings.
Diagram and crate guide: docs/architecture.md.
Contributing
See CONTRIBUTING.md. CI runs cargo fmt --check, cargo clippy -D warnings,
cargo test, and a release build — please make sure those pass locally.
License
MIT — see LICENSE.
tare MCP 질문
tare는 컨텍스트 압축을 어떻게 처리하나요?
도구 출력, 로그, JSON을 더 밀도 높은 동등한 형태로 재인코딩하는 기본 손실 없는 압축 방식을 사용하며, 제공업체의 prefix cache에 대해 캐시 정확성을 유지합니다.
API 키 없이 Claude 구독과 함께 tare를 사용할 수 있나요?
네, tare-mcp를 로컬 stdio 서버로 실행하면 에이전트가 이를 도구로 호출하며, 서버가 직접 모델을 호출할 필요가 없으므로 API 키가 필요하지 않습니다.
tare가 제공업체의 prefix caching을 깨뜨리나요?
아니요, 캐시 중단 지점을 감지하여 동적인 접미사(suffix)만 압축하도록 설계되어 캐시 정확성을 보장합니다.