Shell Runner
Claire-s-Monster/shell-runner
Execução sandboxed de shell com allowlist inteligente e telemetria
Ver no GitHubServidor MCP para execução de comandos shell em ambiente isolado com telemetria e aprendizado adaptativo de lista de permissões. Normaliza comandos, classifica contra padrões conhecidos e aprende automaticamente de execuções seguras para expandir as permissões.
Instalação
npx convez-ai Claire-s-Monster/shell-runner1 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
- Executar comandos do sistema de forma segura via Claude
- Aprender automaticamente padrões de comando legítimos
- Monitorar e registrar execuções de shell com telemetria
Veredito

Ferramenta sólida para quem precisa de execução controlada de shell com segurança em primeiro plano. A abordagem de allowlist adaptativo é inteligente, mas requer gestão cuidadosa em produção para evitar escalonamento não intencional de privilégios.
README
A tradução para o português deste README ainda está na fila.
shell-runner
Sandboxed shell execution MCP server with telemetry and adaptive allowlist learning.
Overview
shell-runner is an HTTP MCP server that provides sandboxed shell execution with:
- Command normalization for consistent telemetry
- Adaptive allowlist learning from execution patterns
- Command classification against known-safe patterns
Development
This project uses pixi for environment management.
# Install environment
pixi install
# Run tests
pixi run test
# Run all quality checks
pixi run check-all
Available Tasks
| Task | Description |
|---|---|
test | Run tests (excludes live and debug) |
test-unit | Run unit tests only |
test-cov | Run tests with coverage report |
lint | Run ruff linter with auto-fix |
format | Run black formatter |
type-check | Run mypy type checker |
quality | Run lint + type-check |
check-all | Run test + quality |
build | Build distribution package |
http-server | Start the HTTP MCP server |
License
MIT License - see LICENSE for details.