How arnavsharma-ind/cerberus- works
Cerberus is an MCP runtime behavioral firewall and SOC control plane. Agents send tool calls through its HTTP or Stdio ingress; Cerberus inspects and scores their behavior, applies policy and security checks, then forwards, blocks, or challenges calls while recording audit evidence. Operators review monitoring, incidents, policies, approvals, and analytics in the dashboard. The README documents major capabilities, but several implementation files were not sampled, so links to those subsystems use README evidence rather than claims of inspected calls.
Main entry points: server.py Proxy Engine · App.tsx React Dashboard · logger.py Audit Ledger · stdio_server.py Stdio Proxy
Components 22
MCP Ingress
- HTTP Gateway
src/cerberus/proxy/server.py - Stdio Proxy
src/cerberus/proxy/stdio_server.py
Runtime Defense
- Tool Call Events
src/cerberus/proxy/models.py - Proxy Engine
src/cerberus/proxy/server.py - Behavior Ensemble
src/cerberus/behavioral/ensemble.py - Baseline Store
src/cerberus/behavioral/baseline_store.py - Schema & Scope
src/cerberus/scanner - Threat Detectors
src/cerberus/detectors - Response Inspection
src/cerberus/proxy/response_inspector.py - OPA Policy
src/cerberus/policy/opa_client.py - Policy Synthesis
src/cerberus/policy/synthesizer.py
Forensics & Operations
- Step-up Challenges
src/cerberus/proxy/challenge_manager.py - Secret Redaction
src/cerberus/proxy/redactor.py - Audit Ledger
src/cerberus/proxy/logger.py - Attack Narratives
src/cerberus/narrative/reconstructor.py - Storage Backend
src/cerberus/storage/backend.py - SOC API
src/cerberus/proxy/soc_routes.py
SOC Console
- React Dashboard
frontend/src/App.tsx - Dashboard API Client
frontend/src/api.ts
Other components
- MCP Agent
- MCP Servers
- Security Operator
Connections 24
- MCP Agent → HTTP Gateway: sends tool calls
README.md - MCP Agent → Stdio Proxy: uses Stdio
README.md - HTTP Gateway → Proxy Engine: processes calls
src/cerberus/proxy/server.py - Stdio Proxy → Proxy Engine: intercepts calls
README.md - Proxy Engine → Tool Call Events: builds events
src/cerberus/proxy/server.py - Proxy Engine → Behavior Ensemble: scores behavior
src/cerberus/proxy/server.py - Proxy Engine → Baseline Store: checks stability
src/cerberus/proxy/server.py - Proxy Engine → Schema & Scope: checks tool scope
README.md - Proxy Engine → Threat Detectors: runs detectors
src/cerberus/proxy/server.py - Proxy Engine → OPA Policy: enforces decisions
src/cerberus/proxy/server.py - Proxy Engine → Response Inspection: inspects responses
src/cerberus/proxy/engine.py - Proxy Engine → Step-up Challenges: requests approval
src/cerberus/proxy/engine.py - Proxy Engine → Secret Redaction: scrubs secrets
README.md - Secret Redaction → Audit Ledger: redacts before persistence
README.md - Proxy Engine → Audit Ledger: records events
README.md - Proxy Engine → MCP Servers: forwards allowed calls
README.md - Policy Synthesis → OPA Policy: pushes Rego policies
README.md - Audit Ledger → Attack Narratives: reconstructs attack chains
README.md - Proxy Engine → Storage Backend: persists state
src/cerberus/proxy/server.py - Security Operator → React Dashboard: reviews security
frontend/src/App.tsx - React Dashboard → Dashboard API Client: requests dashboard data
- Dashboard API Client → SOC API: calls SOC endpoints
- SOC API → Proxy Engine: reads engine state
src/cerberus/proxy/soc_routes.py - React Dashboard → Policy Synthesis: manages policies
README.md