convez.ai
MCP ServerDevOps & InfraestruturaAvançado
Claire-s-Monster

Shell Runner

Claire-s-Monster/shell-runner

Execução sandboxed de shell com allowlist inteligente e telemetria

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-runner

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

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

TaskDescription
testRun tests (excludes live and debug)
test-unitRun unit tests only
test-covRun tests with coverage report
lintRun ruff linter with auto-fix
formatRun black formatter
type-checkRun mypy type checker
qualityRun lint + type-check
check-allRun test + quality
buildBuild distribution package
http-serverStart the HTTP MCP server

License

MIT License - see LICENSE for details.

Ver o original no GitHub

Bom para

Relacionados