Threat Modeling MCP Server

Un server Model Context Protocol (MCP) per un threat modeling completo con validazione guidata del codice.

Indice

• Panoramica
• Prompt di avvio rapido
• Funzionalità principali
• Prerequisiti
• Installazione
• Esecuzione con Kiro CLI
• Gestione dei file di output
• Riferimento rapido
• Panoramica degli strumenti
• Metodologia di threat modeling
• Assunzioni nel threat modeling
• Sviluppo

Panoramica

Questo server fornisce strumenti per il threat modeling, tra cui l'analisi del contesto di business, l'analisi dell'architettura, l'analisi degli attori di minaccia, l'analisi dei confini di fiducia, l'analisi dei flussi di asset, la validazione della sicurezza del codice e la generazione di report completi.

Architettura e approccio

Questo MCP Server invoca l'LLM dell'agente esistente invece di effettuare una chiamata API esterna o di rete verso un servizio diverso. Si basa sull'LLM del client esistente, che potrebbe essere Amazon-Q, Kiro o Cline.

Questo Threat Modeling MCP Server ha tre funzionalità principali:

1. Gestione delle fasi o degli stati del threat modeling e controllo dei prompt.
2. Guida dei prompt, che indirizza l'agente verso un approccio metodico al threat modeling utilizzando definizioni integrate di rischi di business, esposizioni, attori di minaccia e utilizzando STRIDE in ordine sequenziale.
3. Validazione strutturata degli input e controlli di completamento delle fasi che supportano un report di threat model attuabile.

Dispone inoltre di strumenti per generare un report finale in formati esportabili sia Markdown che JSON.

Vantaggi principali di questo approccio

• Questo threat model segue l'approccio standard STRIDE al threat modeling per fasi, anziché giungere a conclusioni rapide su asset, confini e minacce che possono portare ad allucinazioni o output di bassa qualità.
• C'è uno sforzo da parte dell'LLM di comprendere il contesto di business del progetto e formulare assunzioni valide che possono essere controllate dall'utente.
• Questo server locale si basa sull'LLM configurato nel client MCP (Cline, Amazon Q, Kiro) invece di chiamare un'API di modello separata. L'esposizione dei dati dipende dal client e da qualsiasi altro server MCP che il client invoca.
• Il server mantiene il threat model di lavoro in memoria per il processo corrente. Gli strumenti di esportazione possono scrivere snapshot JSON e Markdown in una directory .threatmodel, ma tali snapshot non vengono caricati automaticamente in una sessione successiva.
• Lo strumento di validazione del codice registra le evidenze fornite dal client dopo che questo ha ispezionato l'implementazione, applica le transizioni di stato in modo atomico e blocca la fase finché ogni minaccia e mitigazione corrente non è coperta.

Prompt di avvio rapido ed esempi su come eseguire il threat modeling con questo MCP server

Nota: Prima di utilizzare questi prompt, è necessario completare prima il processo di Installazione per configurare il MCP server.

Avviare un threat model

"Threat model this project using the threat modeling MCP Server"

Essere specifici nel prompt nell'indicare di utilizzare il threat modeling MCP Server assicurerà che il client (Cline/Kiro/ecc.) segua esattamente le fasi e la metodologia invece di prendere scorciatoie e introdurre allucinazioni nei risultati.

Eseguire il threat model di un sottoprogetto o ridurre l'ambito a una sottocartella

"Threat model this subfolder using the threat modeling MCP Server"

Eseguirlo su una sottocartella limita l'ambito di analisi previsto. Per salvare le esportazioni lì, richiedi un percorso di output all'interno di quella sottocartella; la posizione di esportazione non viene dedotta automaticamente dall'ambito di analisi.

Salvare il risultato del threat model

"Save the threat model report"

Validare la completezza del processo di threat modeling

"Please complete all the phases in the threat model plan and then generate the final report."

Fornire come input un'immagine di diagramma dell'architettura

"Threat model this project using the threat model MCP server and consider this architecture_image.png attached for this review"

Tentare di porre rimedio alle minacce

"Can you see if you can implement mitigation controls in the code based on the threats reported in the threat model"

Rigenerare il threat model in base alle correzioni del codice

"Can you updated the threat model based on the code fixes which mitigated the reported threats"

Altri esempi

# Set up context
"Set business context for an e-commerce payment system"

# Add architecture
"Add a web server component using AWS EC2"
"Add a database component using AWS RDS"

# Identify threats
"Add a threat where an attacker with network access performs SQL injection"

# Add mitigations
"Add a mitigation for input validation"

# Export results
"Export the threat model to my_model.tc.json"

Funzionalità principali

• Threat Modeling completo: Approccio strutturato per identificare, valutare e affrontare i rischi di sicurezza
• Validazione del codice basata su evidenze: Registra le evidenze di implementazione, aggiorna gli stati e produce un report deterministico
• Analisi del contesto di business: Comprendere il valore di business e la criticità del sistema
• Analisi dell'architettura: Documentare l'architettura tecnica del sistema e i flussi di dati
• Analisi degli attori di minaccia: Identificare potenziali avversari e valutarne le capacità
• Analisi dei confini di fiducia: Identificare le zone di fiducia e validare i controlli di sicurezza ai confini
• Analisi dei flussi di asset: Tracciare gli asset critici attraverso il sistema
• Identificazione delle minacce: Identificare sistematicamente le potenziali minacce utilizzando la metodologia STRIDE
• Pianificazione delle mitigazioni: Sviluppare strategie per affrontare le minacce identificate
• Domain Manager compatti: Strumenti basati su azioni per assunzioni, architettura, attori, confini, asset, minacce e mitigazioni
• Guida al Threat Model: Guida passo passo attraverso il processo di threat modeling
• Ispezione del modello dati: Uno strumento per elencare i modelli enum e ispezionare i valori accettati

Prerequisiti

Prima di installare il Threat Modeling MCP Server, assicurati di soddisfare i seguenti requisiti:

Requisiti di installazione

1. Installa uvx da Astral o dal README su GitHub
   • uvx fa parte del gestore di pacchetti uv
   • Verifica l'installazione: uvx --version

Installazione

Una volta installato e verificato il funzionamento di uvx, aggiungi la seguente configurazione al tuo file di configurazione mcp.json. A seconda del tipo di client che stai utilizzando (kiro/cline/amazon-q), la posizione di questo mcp.json sarà diversa. Una volta aggiunta la configurazione e riavviato l'IDE, il Threat Modeling MCP Server verrà installato automaticamente direttamente da questo repository GitHub utilizzando uvx.