Independent by design · no pay-to-rank placements  · How we evaluate tools →
Anclum Submit
L

LuminariSoftwares/context-guardian

Independent directory — not the official site. Details below come from the project's public repository.

Status: active development -- changelog

2 ★ measured · checked 2026-11-19

Before you install: command ownership unverified - shown for reference only · license MIT

First step (reference only, ownership unverified): pip install context-guardian && context-guardian # proxy on :8786 in front of Ollama on :11434; set OPENAI_BASE_URL=http:

★ 2·updated 2026-11-12
View on GitHub ↗Direct link · no redirect page

We have no copy-paste install command and no public remote endpoint, so we do not print a config. The step above is reference only, not a command we can vouch for. A made-up one is worse than none. How each client wires MCP up →

Star count
2 ★ · LuminariSoftwares/context-guardian · read from the GitHub search API · (checked 2026-11-19 20:00:48)
Source
collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history
first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
Score
score 300 · 2 ★ · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository LuminariSoftwares/context-guardian;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.
README excerpt (English, untranslated) · Read the full README on GitHub →

Context Guardian

Excerpted from the repository README (abridged)

Status: active development -- changelog
mcp-name: io.github.LuminariSoftwares/context-guardian
A 40-turn session: 1,130,722 tokens sent upstream without it, 161,141 with it.
A compaction proxy for OpenAI-compatible local backends that fails open, so a long session stops dying at the context limit.
https://github.com/user-attachments/assets/1d1d63e9-4e2f-446e-8111-ae56a5a82f7f
## Quick start (60 seconds)
Local model CLI, through the proxy:
bash
pip install context-guardian && context-guardian # proxy on :8786 in front of Ollama on :11434; set OPENAI_BASE_URL=http://localhost:8786/v1
context-guardian-doctor # second terminal: checks the install and the running proxy, prints a fix: line for anything wrong
With an AI agent: paste one line, "Install context-guardian (docs: https://raw.githubusercontent.com/LuminariSoftwares/context-guardian/main/llms.txt) and point my client at it". llms.txt is the whole install, configure, recall and limits story in one short file an agent can read.
Another backend or window: see examples/ or Configure. Your client's settings: Point your client at the proxy. After a compaction, context-guardian-recall " " searches the archived originals (the summary the model receives names the exact command and the MCP tools).
DeepSeek Harness: dsh plugin --profile web add dsh-context-guardian, then npm run setup -- --apply in the installed package. Full steps: Install both.
Claude Code:
bash
pip install context-guardian
context-guardian-claude-code install # prints the hooks and the claude mcp add command; changes nothing
context-guardian-claude-code install --apply # backs up ~/.claude/settings.json, merges the hooks, prints the diff
claude mcp add --scope user --transport stdio context-guardian -- uvx context-guardian mcp
Details: Claude Code.
## Proof
bash
python scripts/bench_proxy.py --turns 40 --seed 1
text
turns=40 tokens_before=1130722 tokens_after=161141 compactions=27
Run 2026-11-05 on v0.15.0, Python 3.11, against a stub upstream.
text
623 passed, 1 warning in 106.22s (0:01:46)
python -m pytest -q, run 2026-11-05.
The bench runs against a stub upstream, not a real model; the token figures are the same on any machine. Fails open. If a summary fails, comes back empty or anything in the proxy raises, the request goes upstream exactly as your client sent it. Ollama (daily use) and DeepSeek Harness 0.1.2-alpha.2 are tested; the other backends and clients in Compatibility are configured from their documentation and marked untested.
Quick start ·
Prove it ·
Client settings ·
Claude Code ·
DeepSeek Harness ·
Recall ·
MCP server ·
Configure ·
Limits ·
Your data ·
Troubleshooting ·
Changelog
What it does. When a conversation is about to outgrow the model's context window, Context Guardian summarises the older turns, keeps the recent ones verbatim and forwards a request that fits. Everything it folds away is archived on disk, sealed in a hash chain you can verify, and indexed so a model can skim it in a few hundred tokens and open only what it needs. It runs on your machine, with no telemetry: nothing leaves it except the requests you were already sending to your own backend, and one cached PyPI version check you can turn off.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/luminarisoftwares-context-guardian/)
Source
awesome · https://github.com/LuminariSoftwares/context-guardian
Browse by field
MCP servers
Traction
2 ★
Listed by
3 independent sources
added
today

More MCP servers

All 6,555 →

Filed under

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index