Servidor MCP de Modelagem de Ameaças

Um servidor Model Context Protocol (MCP) para modelagem abrangente de ameaças com validação automática de código.

Índice

• Visão Geral
• Prompts de Início Rápido
• Principais Funcionalidades
• Pré-requisitos
• Instalação
• Executando com Kiro CLI
• Gerenciamento de Arquivos de Saída
• Referência Rápida
• Visão Geral das Ferramentas
• Metodologia de Modelagem de Ameaças
• Suposições na Modelagem de Ameaças
• Desenvolvimento
• Roteiro

Visão Geral

Este servidor fornece ferramentas para modelagem de ameaças, incluindo análise de contexto de negócios, análise de arquitetura, análise de atores de ameaças, análise de limites de confiança, análise de fluxo de ativos, validação de segurança de código e geração de relatórios abrangentes.

Arquitetura e Abordagem

Este servidor MCP chama o LLM do agente existente em vez de fazer uma chamada de API externa ou de rede para um serviço diferente. Ele depende do LLM do cliente existente, que pode ser Amazon-Q, Kiro ou Cline.

Este servidor MCP de Modelagem de Ameaças tem três funcionalidades principais:

1. Gerenciamento de fase ou estado de modelagem de ameaças e controle de prompts.
2. Direcionamento de prompts, que controla o agente para percorrer uma abordagem metódica de modelagem de ameaças usando definições internas de riscos de negócios, exposições, atores de ameaças e utilizando STRIDE em ordem sequencial.
3. Validação de dados em cada estado ou fase, que por sua vez produz um relatório de modelo de ameaças acionável.

Também possui ferramentas para gerar um relatório final em formatos exportáveis Markdown e JSON.

Principais Vantagens desta Abordagem

• Este modelo de ameaças segue a abordagem STRIDE padrão para modelagem de ameaças em fases, em vez de conclusão rápida de ativos, limites e ameaças, o que pode levar a alucinações ou saída de baixa qualidade.
• Há um esforço do LLM para entender o contexto de negócios do projeto e fazer suposições válidas que podem ser controladas pelo usuário.
• A principal vantagem de usar este servidor MCP de modelagem de ameaças executado localmente é que ele aproveita o LLM existente do cliente (Cline, Amazon-Q, Kiro). Quaisquer dados processados ou enviados são limitados ao cliente ou a outros servidores MCP que você possa ter instalado e invocado. Este servidor não chama nenhuma outra API externa nem envia ou recebe dados além de chamar o LLM do cliente, ou cobrança adicional ou tokens além do que seu cliente já está configurado para usar.
• Esta abordagem de modelagem de ameaças armazena seu modelo de ameaças no mesmo repositório, no diretório .threatmodel, e você pode evoluir seu modelo de ameaças à medida que seu código, design e arquitetura evoluem.
• Esta abordagem de modelo de ameaças analisa o código, se presente, e atualiza as ameaças se elas já forem mitigadas nos controles de nível de código. Você pode reexecutar o modelo de ameaças assim que corrigir seu código, e ele deve analisar a correção para atualizar o modelo de ameaças rapidamente.

Prompts de Início Rápido e Exemplos de como modelar ameaças com este servidor MCP

Nota: Antes de usar esses prompts, você deve primeiro concluir o processo de Instalação para configurar o servidor MCP.

Iniciar um modelo de ameaças```

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

Ser específico no prompt para usar o servidor MCP de modelagem de ameaças garantirá que o cliente (Cline/Kiro/etc) siga as fases e metodologia exatas, em vez de tomar um atalho e introduzir alucinação nos resultados.

### Modele ameaças de um subprojeto ou reduza o escopo para uma subpasta```
"Threat model this subfolder using the threat modeling MCP Server"

Executá-lo em uma subpasta limitará o escopo do modelo de ameaça e do código a essa subpasta e salvará os resultados como um diretório .threatmodel dentro da subpasta.

Salvar o resultado do modelo de ameaça```

"Save the threat model report"

### Validar a completude do processo de modelagem de ameaças```
"Please complete all the phases in the threat model plan and then generate the final report."

Forneça uma imagem de diagrama de arquitetura como entrada```

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

### Tentativa de corrigir as ameaças```
"Can you see if you can implement mitigation controls in the code based on the threats reported in the threat model"

Regenerar modelo de ameaças com base em correções de código```

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

### Mais exemplos```bash
# 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.json"

Principais Recursos

• Modelagem de Ameaças Abrangente: Abordagem estruturada para identificar, avaliar e lidar com riscos de segurança
• Validação Automática de Código: Detecta código no diretório do projeto e valida automaticamente o modelo de ameaças contra ele
• Análise de Contexto de Negócios: Entender o valor comercial e a criticidade do sistema
• Análise de Arquitetura: Documentar a arquitetura técnica e os fluxos de dados do sistema
• Análise de Atores de Ameaça: Identificar potenciais adversários e avaliar suas capacidades
• Análise de Limites de Confiança: Identificar zonas de confiança e validar controles de segurança nos limites
• Análise de Fluxo de Ativos: Rastrear ativos críticos através do sistema
• Identificação de Ameaças: Identificar sistematicamente ameaças potenciais usando a metodologia STRIDE
• Planejamento de Mitigações: Desenvolver estratégias para lidar com ameaças identificadas
• Gerenciamento de Suposições: Ferramentas para adicionar, listar, atualizar e excluir suposições no modelo de ameaças
• Gerador de Ameaças: Ferramentas para adicionar e gerenciar ameaças no modelo
• Gerenciamento de Mitigações: Ferramentas para gerenciar mitigações e vinculá-las a ameaças
• Guia de Modelagem de Ameaças: Orientação passo a passo através do processo de modelagem de ameaças
• Tipos de Modelo de Dados: Ferramentas para explorar tipos de modelo de dados disponíveis e enumerações

Pré-requisitos

Antes de instalar o Threat Modeling MCP Server, verifique se você possui os seguintes requisitos:

Requisitos de Instalação

1. Instale o uvx a partir do Astral ou do GitHub README
   • uvx faz parte do gerenciador de pacotes uv
   • Verifique a instalação: uvx --version

Instalação

Depois de ter o uvx instalado e verificado que está funcionando, adicione a configuração abaixo ao seu arquivo de configuração mcp.json. Dependendo do tipo de cliente que você está usando (kiro/cline/amazon-q), a localização deste mcp.json será diferente. Depois de adicionar a configuração e reiniciar sua IDE, o Threat Modeling MCP Server será instalado automaticamente diretamente deste repositório GitHub usando uvx.