convez.ai
MCP ServerSegurançaIntermediário
Noumenon-ai

HEXIS MCP Guard

Noumenon-ai/hexis-mcp-guard

Análise estática + dinâmica de segurança para MCP servers com 14 regras e SARIF

Ver no GitHub
InicialPluginScore · de 0 a 100

Scanner de segurança para servidores MCP (Model Context Protocol) que realiza análise estática com 14 regras de segurança específicas para vulnerabilidades comuns em integração com LLMs. Gera relatórios SARIF para integração nativa com a aba Security do GitHub e suporta CI/CD com exit codes configuráveis.

Instalação

$npx convez-ai Noumenon-ai/hexis-mcp-guard

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
1
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
3

Casos de uso

  • Auditoria de segurança em MCP servers antes do deploy
  • Integração em pipelines CI/CD para detecção automática de vulnerabilidades
  • Validação de proteção contra SSRF, injeção SQL, shell injection e prompt injection

Veredito

Ferramenta especializada e bem pensada para um nicho real (segurança de MCP servers). As 14 regras cobrem ameaças específicas de integração LLM. SARIF nativo + CI/CD ready tornam adoção prática em times DevOps. Recomendado para quem opera MCP em produção.

README

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

HEXIS MCP GUARD

Security scanner for MCP (Model Context Protocol) servers.

Install

pip install hexis-mcp-guard

Or from source:

git clone https://github.com/Noumenon-ai/hexis-mcp-guard.git
cd hexis-mcp-guard
pip install -e ".[dev]"

Usage

hexis scan ./my-server/
hexis scan --format sarif -o results.sarif ./server/
hexis scan --format json ./server/
hexis scan --url http://localhost:8080 --dynamic
hexis scan ./server/ --ai
hexis scan ./server/ --ci --fail-on high
hexis scan ./server/ --baseline .hexis-baseline.json
hexis rules

Features

  • 14 security rules (SSRF, shell injection, auth, prompt injection, resource exposure, transport)
  • Static analysis + dynamic probing
  • SARIF 2.1.0 output for GitHub Security tab
  • JSON + rich terminal output
  • CI/CD ready (exit codes)
  • Optional AI reasoning (Claude)

Rules

RuleSeverityCategoryDescription
HEXIS-AUTH-001HIGHauthNo authentication on transport
HEXIS-AUTH-002HIGHauthMissing authorization checks on sensitive tools
HEXIS-CMD-001CRITICALshell_injectionsubprocess/exec with user input
HEXIS-CMD-002CRITICALshell_injectionshell=True with string interpolation
HEXIS-CMD-003CRITICALshell_injectioneval/exec on tool arguments
HEXIS-PI-001HIGHprompt_injectionTool description contains injection patterns
HEXIS-PI-002MEDIUMprompt_injectionReturn values flow unsanitized to LLM context
HEXIS-PI-003HIGHprompt_injectionTool poisoning via hidden instructions in descriptions
HEXIS-RES-001HIGHresource_exposureUnrestricted file system access
HEXIS-RES-002HIGHresource_exposureSQL query tool without parameterization
HEXIS-SSRF-001HIGHssrfURL parameter in tool inputSchema without validation
HEXIS-SSRF-002CRITICALssrfServer-side fetch with user-controlled URL
HEXIS-SSRF-003CRITICALssrfInternal IP/metadata endpoint accessible
HEXIS-TLS-001MEDIUMtransportPlaintext HTTP transport in production

CI/CD Integration

GitHub Actions

- name: MCP Security Scan
  run: |
    pip install hexis-mcp-guard
    hexis scan ./src --format sarif --output results.sarif --ci --fail-on high

- name: Upload SARIF
  uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: results.sarif

Exit Codes

CodeMeaning
0No HIGH/CRITICAL findings
1HIGH findings detected
2CRITICAL findings detected

License

MIT

Built by Noumenon

Ver o original no GitHub

Bom para

Relacionados