getagentseal/agentsealFerramenta de segurança para agentes de IA. Escaneie sua máquina em busca de habilidades perigosas e configurações MCP, monitore ataques à cadeia de suprimentos, teste a resistência a injeção de prompt e audite servidores MCP ativos em busca de envenenamento de ferramentas.
Documentação · Registro MCP · Painel · Blog
pip install agentseal # ou: npm install agentseal
agentseal guard # escaneie sua máquina - sem necessidade de chave API
É isso. O AgentSeal encontra arquivos de habilidade perigosos, configurações de servidor MCP envenenadas e caminhos de exfiltração de dados em todos os agentes de IA da sua máquina.
Quer testar um prompt de sistema contra ataques adversariais?
agentseal scan --prompt "Você é um assistente prestativo..." --model ollama/llama3.1:8b # gratuito, local
agentseal scan --prompt "Você é um assistente prestativo..." --model gpt-4o # nuvem
| Comando | O que faz | Precisa de um LLM? |
|---|---|---|
guard | Verifica arquivos de habilidade, configurações MCP, fluxos de dados tóxicos e alterações na cadeia de suprimentos em sua máquina | Não |
scan | Testa um prompt de sistema contra mais de 225 sondas de ataque adversariais | Sim* |
scan-mcp | Conecta-se a um servidor MCP ativo e audita suas descrições de ferramentas em busca de envenenamento | Não |
shield | Monitora arquivos de configuração de agente em tempo real, alerta sobre ameaças e coloca payloads em quarentena | Não |
*Gratuito com Ollama. Provedores em nuvem (OpenAI, Anthropic, etc.) exigem uma chave API.
Escaneia todas as configurações de agentes de IA na sua máquina. Sem chave API, sem chamadas de rede – tudo é executado localmente.
Agentes suportados: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Gemini CLI, Codex CLI, Cline, Roo Code, Kilo Code, Copilot CLI, Aider, Continue, Zed, Amp, Amazon Q, Junie, Goose, Kiro, OpenCode, OpenClaw, Crush, Qwen Code, Grok CLI, Visual Studio, Kimi CLI, Trae, MaxClaw.
agentseal guard
O Guard executa um pipeline de detecção de seis estágios em cada arquivo que encontra:
agentseal guard init # gera .agentseal.yaml política de projeto
agentseal guard --output sarif # SARIF para a guia de Segurança do GitHub
agentseal guard --output json # saída legível por máquina
agentseal guard --no-diff # pula a seção de delta da baseline
agentseal guard test # valida suas regras personalizadas
Testa um prompt de sistema contra 225 sondas de ataque adversariais: 82 técnicas de extração, 143 técnicas de injeção e 8 transformações de mutação adaptativa. Retorna uma pontuação de confiança determinística.
Como funciona a detecção: As sondas de injeção incorporam uma string canário única (por exemplo, SEAL_A1B2C3D4_CONFIRMED). Se o canário aparecer na resposta, a sonda vazou. As sondas de extração usam correspondência de n-gramas contra o prompt de verdade fundamental. Sem juiz LLM – mesma entrada, mesmo resultado, sempre.
Pontuação de confiança (0–100):
| Pontuação | Nível | Significado |
|---|---|---|
| 85–100 | Excelente | Defesas fortes, resiste à maioria dos ataques conhecidos |
| 70–84 | Alto | Boas defesas, lacunas menores |
| 50–69 | Médio | Risco moderado, várias categorias de sonda vazaram |
| 30–49 | Baixo | Vulnerabilidades significativas |
| 0–29 | Crítico | Defesa mínima ou nenhuma contra ataques de prompt |
# OpenAI
agentseal scan --prompt "Você é um assistente prestativo..." --model gpt-4o
# Anthropic
agentseal scan --prompt "Você é um assistente prestativo..." --model claude-sonnet-4-5-20250929
# Ollama (gratuito, local)
agentseal scan --prompt "Você é um assistente prestativo..." --model ollama/llama3.1:8b
# Qualquer endpoint HTTP
agentseal scan --url http://localhost:8080/chat
# A partir de um arquivo
agentseal scan --file ./prompt.txt --model gpt-4o
agentseal scan --file ./prompt.txt --model gpt-4o --min-score 75
Código de saída 1 se a pontuação de confiança estiver abaixo do limite. Use --output sarif para integração com a guia de Segurança do GitHub.
Conecta-se a um servidor MCP ativo via stdio ou SSE. Enumera todas as ferramentas, depois executa cada descrição por meio de correspondência de padrões, desofuscação, similaridade semântica e classificação opcional por LLM. Gera uma pontuação de confiança por servidor.
# Servidor stdio
agentseal scan-mcp --server npx @modelcontextprotocol/server-filesystem /tmp
# Servidor SSE
agentseal scan-mcp --sse http://localhost:3001/sse
Detecta envenenamento de descrição de ferramenta – instruções ocultas embutidas nas descrições de ferramenta que fazem o agente exfiltrar dados, executar comandos ou substituir a intenção do usuário.
Observador de arquivos em tempo real para caminhos de configuração de agente. Notificações na área de trabalho quando surgem ameaças. Coloca automaticamente em quarentena arquivos com payloads detectados.
pip install agentseal[shield] # inclui watchdog + dependências de notificação na área de trabalho
agentseal shield
Monitora os mesmos caminhos que o guard escaneia, mas de forma contínua. Útil para detectar ataques à cadeia de suprimentos onde um npm install ou pip install modifica silenciosamente suas configurações de agente.
Servidores MCP dão aos agentes de IA acesso a arquivos locais, bancos de dados, APIs e credenciais. Descrições de ferramenta podem conter instruções ocultas que o agente segue, mas o usuário nunca vê.