convez.ai
MCP ServerSegurançaAvançado
angelica-han

MCP Security Analysis Multi-Agent

angelica-han/MCP-Security-Analysis-Multi-Agent

Scanner de segurança multi-agente para projetos MCP com análise estática e validação de achados

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP baseado em LangGraph que analisa projetos de segurança para detectar vulnerabilidades em múltiplos eixos: injeção de prompt, SSRF, execução de comandos e acesso a arquivos. Usa análise estática determinística (AST + regex) com orquestração de agentes especializados para gerar relatórios estruturados com cadeias de evidência.

Instalação

$npx convez-ai angelica-han/MCP-Security-Analysis-Multi-Agent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Auditar servidores/clientes MCP antes de produção
  • Detectar vulnerabilidades de injeção de prompt e SSRF em código Python/JS
  • Gerar relatórios de segurança estruturados com evidência e caminhos de ataque

Veredito

Ferramenta sólida e bem-arquitetada para segurança de MCP servers. Combina análise estática determinística com orquestração de agentes LangGraph, evitando alucinações através de Pydantic schemas. Pronta para uso em pipelines de CI/CD, com suporte a extensão futura via agentes adicionais.

README

A tradução para o português deste README ainda está na fila.

MCP Security Analysis Multi-Agent

A LangGraph-powered multi-agent system that analyzes MCP (Model Context Protocol) project directories for security vulnerabilities and generates evidence-backed reports.


What It Does

Point it at any MCP server/client project directory, and it will:

  1. Scan the directory — inventory all source files and filter out noise
  2. Profile the project — understand what MCP capabilities it exposes and where the trust boundaries are
  3. Extract code features — use static analysis (AST + regex) to find dangerous patterns like shell calls, file access, and network requests
  4. Run risk agents — specialized agents scan for different vulnerability classes in parallel (four live today, a fifth planned)
  5. Evaluate quality — an Evaluator checks that every finding has real evidence; low-confidence findings get flagged or sent back for re-scan
  6. Generate a report — structured Markdown + JSON output with evidence chains, attack paths, and remediation suggestions

Risk Categories

AgentWhat It Looks For
Prompt InjectionUser/remote content entering system prompts or tool descriptions
Command Executionshell=True, command concatenation, unvalidated parameters
File AccessPath traversal, sensitive directory reads, missing allowlists
Network RequestSSRF, arbitrary URLs, internal network access
Lifecycle (planned)Session state leakage, incomplete cleanup, log leakage

Tech Stack

  • LangGraph — multi-agent orchestration (StateGraph, conditional routing, feedback loops)
  • Pydantic — typed schemas for all inter-agent data; prevents hallucinated evidence
  • Python AST module — deterministic code feature extraction (no LLM guessing)
  • LangChain / LLM layer (V2) — semantic interpretation for capability analysis, supervisor routing, and report generation; all V1 agents are deterministic rule-based

Project Structure

mcp_security_agent/
├── schemas.py          # All data structures (GraphState, RiskFinding, etc.)
├── graph.py            # LangGraph graph: nodes, edges, conditional routing
├── cli.py              # Command-line entry point
├── agents/
│   ├── functional.py           # Capability analysis agent
│   ├── risk_prompt_injection.py
│   ├── risk_command.py
│   ├── risk_file.py
│   ├── risk_network.py
│   ├── risk_lifecycle.py
│   ├── evaluator.py
│   └── reporter.py
└── tools/
    ├── file_inventory.py   # Directory walker and file filter
    ├── ast_scanner.py      # Python AST-based feature extraction
    └── regex_scanner.py    # Pattern matching for JS/TS and config files
results/                # Output reports land here (gitignored)
sample_mcp_server/      # Deliberately vulnerable MCP server used as scan target
tests/fixtures/         # Test fixtures

Quickstart

# Install dependencies
pip install langgraph pydantic

# Run the full pipeline against the sample vulnerable server
python -m mcp_security_agent.graph

No API key needed yet — the current risk agents use deterministic static analysis (AST + regex), not LLM calls. The report is written to results/.

Current Status

ComponentStatus
Project structure✅ Done
Pydantic schemas✅ Done
LangGraph graph✅ Done — all nodes connected, full pipeline runs end-to-end
Directory inventory✅ Done
Code feature extraction (AST scanner)✅ Done
Risk agents: command, file, network, prompt injection✅ Done — real static-analysis logic
Capability analysis agent (functional.py)✅ Done — rule-based, infers project type + sensitive capabilities from AST features
Supervisor routing✅ Done — activates only relevant scan categories based on detected capabilities
Evaluator agent✅ Done — confidence threshold, proximity-based dedup, coverage gap detection, rerun loop
Reporter agent✅ Done — structured Markdown with severity grouping, action plan (P0/P1/P2), coverage notes
Risk agent: lifecycle⏳ Planned — session state leakage, incomplete cleanup, log leakage
Regex scanner (JS/TS targets)⏳ Planned
CLI entry point⏳ Planned

Design Principles

  • Evidence-first: every RiskFinding must include a file path, line range, and code snippet — findings without evidence are rejected by the Evaluator
  • Deterministic before LLM: file scanning, AST parsing, and regex matching run as plain Python tools; the LLM handles semantic interpretation and risk explanation only
  • Structured outputs: all agent outputs are typed Pydantic models, not free text — enables automated testing and downstream processing
  • Replayable: the graph can regenerate a report from intermediate JSON for debugging and demos
Ver o original no GitHub

Bom para

Relacionados