projectbrain-mcp

# ProjectBrain (`projectbrain-mcp`) [](https://pypi.org/project/projectbrain-mcp/) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) **Local-First AST Context Compiler, Closed-World Engineering Dossier, and Surgical Anchor Patch Engine for AI Coding Agents.** ProjectBrain indexes your codebase into a typed AST & call-graph (`file`, `fn`, `cls`, `route`, `mod`) in `~90ms` using pre-compiled `tree-sitter` C wheels—no external database, no Docker, no vector embeddings, and no LLM required. It cuts coding-agent token bills by **60%–65%** while speeding up multi-file debugging and editing by **30%–42%**: - **Input Token Reduction (`-81.3%` to `-88.3%` code tokens, `-73.2%` to `-76.3%` billed prompt tokens):** Compiles module constants, smart-folded AST function slices, 1–3 hop bidirectional call chains with `@L<line>` caller windows, and a **Closed-World Exhaustive Repo Scan** into a single `<800`-line `.projectbrain_dossier.md` read in **1 `read_file` call**. - **Output Token Reduction (`-63.2%` to `-77.3%` edit output tokens):** Replaces verbatim `Target` + `Replacement` repetition (`edit_file`) with a compact Anchor Patch DSL (`@file`, `@sub`, `@replace`, `@insert_after`, `@delete`) validated by Tree-sitter in `<5ms`. - **Live ROI & Token Savings Ledger (`projectbrain stats --summary`):** Tracks cumulative input/output tokens saved, file reads avoided, estimated USD saved, and developer wait-time saved in `.projectbrain_ledger.json`. --- ## Step-by-Step Setup Guide (60 Seconds) ### Step 1: Install from PyPI Install `projectbrain-mcp` globally (or in your active Python environment): ```bash pip install projectbrain-mcp ``` *(Alternatively, use `pipx install projectbrain-mcp` or `uv tool install projectbrain-mcp`.)* …