MCP Context Guard — Context Window Management for AI Agents

Compress tool outputs, manage token budgets, deduplicate content, and filter by relevance. Zero dependencies, pure Python stdlib.

The Problem

AI agents waste context window tokens on:

• Verbose tool outputs (file reads, search results, logs)

• Duplicate content across tool calls

• Irrelevant passages that don't match the task

Related MCP server: toonify-mcp

The Solution

MCP Context Guard sits between your tools and the LLM, compressing and filtering everything that enters the context window.

Tools (14)

Install

git clone https://github.com/aaameobius-crypto/mcp-context-guard.git
cd mcp-context-guard
python -m src.server --stdio

Tests

python -m pytest tests/ -v  # 36 tests, all passing

Inspiration

• headroom — 60-95% token reduction

• context-mode — Intercept tool output

• LLMLingua — Prompt compression

• Autonomous Context Compression

License

MIT — AMEOBIUS