MCP Security Scanner
HailBytes/mcp-security-scanner
Audita servidores MCP para falhas de segurança e má configuração
Ver no GitHubAudita configurações de servidores MCP em busca de vulnerabilidades comuns como ferramentas com permissões excessivas, autenticação ausente, superfícies de injeção de prompt e padrões inseguros. Integra-se em pipelines CI/CD como gate de segurança ou executa sob demanda via CLI.
Instalação
npx convez-ai HailBytes/mcp-security-scanner1 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
Casos de uso
- Validar segurança de configurações MCP em CI/CD
- Detectar ferramentas com permissões excessivas antes do deploy
- Identificar superfícies de ataque por injeção de prompt
- Auditar transporte inseguro e autenticação fraca
Veredito

Ferramenta especializada e necessária para times que rodam servidores MCP em produção. Preenche um gap real de segurança ao automatizar auditoria de configurações, com integração nativa em CI/CD e output em SARIF.
README
A tradução para o português deste README ainda está na fila.
@hailbytes/mcp-security-scanner
Scans Model Context Protocol (MCP) server configurations for common security issues: overprivileged tools, missing auth, prompt injection surface, and unsafe defaults.
What it does
Audit MCP server configurations and endpoints for the most common AI security mistakes — overprivileged tools, missing authentication, prompt injection attack surface, and insecure transport defaults. Integrates into CI/CD as a gate or run on-demand via CLI.
Install
npm install -g @hailbytes/mcp-security-scanner
# or use directly via npx
npx @hailbytes/mcp-security-scanner ./mcp-config.json
Quick Start
CLI
# Scan a local config file
npx @hailbytes/mcp-security-scanner ./mcp-config.json
# Scan a running MCP server endpoint
npx @hailbytes/mcp-security-scanner https://my-mcp-server.example.com
# Output SARIF for GitHub Code Scanning + fail on findings
npx @hailbytes/mcp-security-scanner ./config.json --format=sarif --exit-code
Programmatic
import { scan } from "@hailbytes/mcp-security-scanner";
const report = await scan({ configPath: "./mcp-config.json" });
console.log(report.findings); // Finding[] — individual security issues
console.log(report.score); // 0–100 risk score (higher = riskier)
console.log(report.passed); // boolean — use as CI gate
What It Checks
- Overprivileged tools — tools granted broader permissions than their declared function requires
- Missing or weak authentication — unauthenticated transports, missing token validation
- Prompt injection surface — tool descriptions or output paths susceptible to injection
- Unsafe defaults — insecure transport defaults, verbose error exposure, CORS wildcards
See Also
@hailbytes/mcp-server-template— production-ready MCP server scaffold with auth built-in- HailBytes MCP documentation
Part of the HailBytes open-source security toolkit.