How khaledobeid/multi-agent-mcp-security-auditor works
This is a multi-agent auditor for third-party MCP servers and AI-agent tool packages. A user submits a package through the CLI; the graph prepares audit state, inspects manifests and permissions, maps findings to OWASP guidance and dependency vulnerabilities, conditionally red-teams dangerous packages, then produces a verdict and patched manifest. The graph and shared state are the internal orchestration layer. The README documents capabilities not fully shown in excerpts; links based on those statements are cited there, and unsampled implementation details are not inferred.
Main entry points: graph.py Audit graph · inspector.py Surface inspector · threat_analyst.py Threat analyst · llm.py LLM and embeddings
Components 26
Entry and orchestration
- Audit CLI
src/mcp_security_auditor/main.py - Audit graph
src/mcp_security_auditor/graph.py
Audit agents
- Package intake
src/mcp_security_auditor/agents/intake.py - Surface inspector
src/mcp_security_auditor/agents/inspector.py - Threat analyst
src/mcp_security_auditor/agents/threat_analyst.py - Red-team agent
src/mcp_security_auditor/agents/red_team.py - Report and verdict
src/mcp_security_auditor/agents/report.py
Analysis tools
- Manifest scanner
src/mcp_security_auditor/tools/manifest_scanner.py - Permission diff
src/mcp_security_auditor/tools/permission_diff.py - Dependency lookup
src/mcp_security_auditor/tools/osv.py - Sandbox test
src/mcp_security_auditor/tools/sandbox.py - Manifest patcher
src/mcp_security_auditor/tools/patcher.py
Shared runtime
- Audit state
src/mcp_security_auditor/state.py - Audit contracts
src/mcp_security_auditor/schemas.py - Agent turn loop
src/mcp_security_auditor/utils/agent_loop.py - Tool execution
src/mcp_security_auditor/utils/tool_exec.py - Message helpers
src/mcp_security_auditor/utils/messages.py - Untrusted text handling
src/mcp_security_auditor/utils/text.py - LLM and embeddings
src/mcp_security_auditor/llm.py - Runtime settings
src/mcp_security_auditor/config.py
Security knowledge
- Security retrieval
src/mcp_security_auditor/tools/rag.py - Corpus ingestion
src/mcp_security_auditor/rag/ingest.py - Vector store
Other components
- Package submitter
- Gemini services
- OSV.dev
Connections 28
- Package submitter → Audit CLI: submits package
README.md - Audit CLI → Audit graph: runs audit
src/mcp_security_auditor/main.py - Audit graph → Package intake: starts at
src/mcp_security_auditor/graph.py - Audit graph → Surface inspector: dispatches
src/mcp_security_auditor/graph.py - Audit graph → Threat analyst: dispatches
src/mcp_security_auditor/graph.py - Audit graph → Red-team agent: conditionally dispatches
src/mcp_security_auditor/graph.py - Audit graph → Report and verdict: dispatches
src/mcp_security_auditor/graph.py - Audit graph → Audit state: uses
src/mcp_security_auditor/graph.py - Package intake → Audit state: updates
README.md - Surface inspector → Manifest scanner: scans package
src/mcp_security_auditor/agents/inspector.py - Surface inspector → Permission diff: checks permissions
src/mcp_security_auditor/agents/inspector.py - Surface inspector → Agent turn loop: requests agent turn
src/mcp_security_auditor/agents/inspector.py - Threat analyst → Security retrieval: searches guidance
src/mcp_security_auditor/agents/threat_analyst.py - Threat analyst → Dependency lookup: checks dependencies
src/mcp_security_auditor/agents/threat_analyst.py - Threat analyst → Agent turn loop: requests agent turn
src/mcp_security_auditor/agents/threat_analyst.py - Red-team agent → Sandbox test: tests suspicious tools
README.md - Report and verdict → Manifest patcher: patches manifest
src/mcp_security_auditor/agents/report.py - Surface inspector → Tool execution: executes tool calls
src/mcp_security_auditor/agents/inspector.py - Surface inspector → Untrusted text handling: formats package brief
src/mcp_security_auditor/agents/inspector.py - Audit CLI → Message helpers: prints run messages
README.md - Agent turn loop → LLM and embeddings: requests model
src/mcp_security_auditor/utils/agent_loop.py - LLM and embeddings → Runtime settings: reads model settings
src/mcp_security_auditor/llm.py - LLM and embeddings → Gemini services: calls
src/mcp_security_auditor/llm.py - Security retrieval → LLM and embeddings: gets embeddings
src/mcp_security_auditor/tools/rag.py - Security retrieval → Vector store: searches
src/mcp_security_auditor/tools/rag.py - Corpus ingestion → Vector store: builds
README.md - Dependency lookup → OSV.dev: queries
README.md - Audit contracts → Audit state: defines state types
src/mcp_security_auditor/state.py