@bc360/shell

MCP shell server de B Consulting 360. Ejecuta comandos en CMD o PowerShell con salida UTF-8 garantizada (smartDecode CP850), timeouts configurables y stderr sin falsos errores. Sucesor de shell-runner-neo.

Instalación (Claude Desktop)

Requiere Node.js >= 18. Agregar en %APPDATA%\Claude\claude_desktop_config.json dentro de mcpServers:

"bc360-shell": {
  "command": "npx",
  "args": ["-y", "@bc360/shell"]
}

Reiniciar Claude Desktop. Sustituye a las entradas shell (shell-runner-neo) y desktop-commander.

Herramientas

• shell_execute — comando con shell opcional ("cmd" | "powershell"), timeout_ms, cwd y expected_exit_codes; solo un exit code != 0 no previsto es error
• get_config / set_config_value — config en ~/.bc360-shell/config.json (defaultShell, defaultTimeoutMs, cmdFallbackEncoding, errorLogEnabled)

Comportamiento

• Timeouts y cancelación: al vencer timeout_ms, o si Claude Desktop deja de esperar, se termina el proceso con todos sus subprocesos (en Windows no quedan huérfanos). No pedir timeout_ms >= 4 min (techo de Claude Desktop).
• Stdin cerrado: comandos interactivos de teclado fallan rápido; los que esperan red (ej. npm login) solo se cortan por timeout.
• Python: se inyectan PYTHONUTF8=1, PYTHONIOENCODING=utf-8 y PYTHONUNBUFFERED=1: acentos y emojis sin configuración, y salida parcial visible cuando hay timeout.
• Errores esperados: si el exit code está en expected_exit_codes, se devuelve como [esperado] Exit code: N sin marcar error.
• Bitácora de errores reales: todo error no previsto (exit code, timeout, cancelación) se registra en ~/.bc360-shell/errores.jsonl con secretos censurados (--password, --value, API_KEY=, Bearer, --settings de appsettings, etc.). Se apaga con set_config_value errorLogEnabled false.

Desarrollo

Repo: https://dev.azure.com/bconsulting360/mcps/_git/shell