MCP Context Condenser — Token-Slimming AST Code Outliner & Log Compressor

⚡ Stop Bleeding Tokens on Raw File Dumps

Every time your AI coding assistant (Cursor, Claude Desktop, Cline, or Antigravity) reads an entire 1,500-line file just to tweak a single helper function, you pay twice:

1. Financial Bleed: Massive prompt token burns ($15–$50/day) on frontier model context windows.
2. "Lost in the Middle" Degradation: Drowning LLMs in boilerplate internal implementations increases hallucination rates and degrades attention to subtle requirements.

MCP Context Condenser is a lightweight, zero-dependency MCP server and terminal CLI that intercepts massive files and compresses them into high-density context using AST analysis before they ever hit your LLM context window.

---

🌟 Key Superpowers

• AST Structural Outlining (condense_source): Extracts type-safe code skeletons preserving imports, interfaces, type aliases, and exported method signatures while condensing function bodies. Slashes token counts by up to 85% while giving the AI 100% architectural visibility.
• Surgical Symbol Extraction (extract_symbol): Plucks only the exact function, class, or interface you need to inspect or refactor, pulling in file-level imports and skipping thousands of irrelevant lines.
• Noise-Free Log Compression (compress_log): Strips noisy test passes and compiler spam, passing only the root-cause assertion failures and stack frames.
• Token Budget Guardrail (token_budget): Analyzes token weight (~3.8 chars/token) and provides proactive warnings before ingesting oversized files.
• Dual Mode: Runs seamlessly as an MCP stdio server or as a standalone terminal CLI.

---

📊 Before vs. After Benchmark

RAW INPUT:      450 lines | ~4,820 tokens | Slow response | Context bloat
CONDENSED AST:   58 lines |   ~680 tokens | 85.9% saved   | Razor-sharp accuracy

---

📦 Bundle Contents

• Full TypeScript Source Code (Modular, fully typed, 100% test coverage)
• Pre-compiled zero-install Node.js bundle (dist/index.js, <10ms startup)
• Standalone CLI binary for terminal workflows
• Configuration snippets for Claude Desktop, Cursor, and Cline
• Commercial MIT License