MCP server for deterministic context budget management in Claude Code. Nerf tracks token consumption, enforces soft limits, and triggers doom modes when context budgets are exceeded.
- Claude Code CLI (
claude) - Bun (for development)
Installation instructions will be added once the server has tools to offer.
git clone https://github.com/Wave-Engineering/mcp-server-nerf.git
cd mcp-server-nerf
bun installbun testbun run lintscripts/ci/validate.shscripts/ci/build.sh bun-linux-x64
scripts/ci/build.sh bun-darwin-arm64Nerf is an MCP server that communicates over stdio transport. It will expose tools for:
- Budget declaration and tracking
- Soft-limit enforcement with warnings
- Doom mode activation when budgets are exceeded
- Scope monitoring and reporting
MIT -- see LICENSE.