Context Bunker MCP 🏗️

Stop wasting tokens on orientation. Pre-computed codebase intelligence for AI coding tools. One command. Code never leaves your machine.

What is this?

AI coding agents spend ~80% of tokens just figuring out where things are — re-reading files, tracing imports, grepping for symbols. Every. Single. Session.

Context Bunker fixes this. It's an MCP server that indexes your codebase using tree-sitter AST parsing and gives your AI tools instant access to structural intelligence — dependency graphs, call trees, dead code, cross-session diffs — all from a local SQLite database.

One call replaces 8-16 grep/read calls. ~90% token savings. Zero cloud. Zero API keys.

Works with Claude Code, Cursor, Windsurf, Copilot, and any MCP-compatible client.

Why not just grep? Grep finds text. Context Bunker understands structure — dependency graphs, cross-session memory, dead code detection, and token-efficient summaries. Things grep structurally can't do. Full comparison.

Setup

Install

# Run directly — no install needed
bunx context-bunker-mcp /your/project

# Or install globally
bun install -g context-bunker-mcp

# No Bun? npx / npm work too

Add to your AI tool

Claude Code:

# With a project (auto-indexes on startup)
claude mcp add context-bunker -- bunx context-bunker-mcp /your/project

# Without a project (AI calls set_project dynamically)
claude mcp add context-bunker -- bunx context-bunker-mcp

# No Bun? npx work too

Cursor / Windsurf / VS Code — add to settings.json:

{
  "mcpServers": {
    "context-bunker": {
      "command": "bunx",
      "args": ["context-bunker-mcp", "/your/project"]
    }
  }
}

Tools (16)

Tool	What it does
🔥 get_changes_since_last_session	What changed since the AI last looked. No more re-orientation.
🔥 find_unused_exports	Dead code detection — exported but never imported anywhere.
🔥 find_unused_code	Find dead internal code — functions, classes, variables, types never referenced.
🔥 get_file_summary	File overview in ~50 tokens. Scan 10 files for the cost of 1.
🔥 search_by_pattern	Find structural patterns: HTTP calls, env access, error handlers, async, TODOs.
🧠 get_smart_context	Full file context in 1 call — imports, exports, dependents, types, tests.
🧠 get_dependency_graph	"If I change this, what breaks?" — transitive import graph with depth control.
🧠 find_symbol	AST-aware symbol search by name, kind, and scope. Not text matching.
🧠 find_references	Where a symbol is used, classified by kind (import, call, type annotation).
🧠 get_call_graph	What a function calls, recursively, as a tree.
🧠 get_symbol_source	Extract one definition — not the whole file. 80% token savings.
🧠 get_project_map	Architecture overview: modules, public APIs, relationships.
🔧 set_project	Point the index at any project directory on the fly.
🔧 search_code	Semantic search via local TF-IDF. No API keys needed.
🔧 reindex	Force re-index of the codebase or a single file.
🔧 get_status	Index health, file counts, token savings estimate.

🔥 Unique   🧠 Core Intelligence   🔧 Housekeeping

Language Support

TypeScript, JavaScript (TSX/JSX/MTS/CTS), Python, Go, Rust, Java, C#

Powered by tree-sitter WASM grammars. Adding a new language = one extractor file in src/languages/.

Tech Stack

Runtime	Bun (Node.js fallback) — bun:sqlite = zero native deps, 4-10x faster startup
MCP	@modelcontextprotocol/sdk
AST	web-tree-sitter (WASM) — no native bindings, works everywhere
Storage	SQLite (WAL mode) — single file, survives restarts
Search	TF-IDF (local) — zero API keys, no cloud
Watch	chokidar — incremental re-index on file changes

Storage

The index lives in your OS cache directory — not inside the project. No .gitignore needed.

Platform	Location
macOS	~/Library/Caches/context-bunker/<project>/index.db
Linux	~/.cache/context-bunker/<project>/index.db
Windows	%LOCALAPPDATA%\context-bunker\<project>\index.db

Want it inside the project instead? Use --local or set { "storage": "local" } in .context-bunker.json.

License

MIT