ooples avatar

Mcp Console Automation

ooples/mcp-console-automation

Think Playwright but for terminal automation. This server gives Claude full control over console sessions with 40 tools spanning session management, SSH connections, background jobs, and test assertions. You can spin up multiple shells (cmd, PowerShell, bash, zsh), send input including special keys, capture and filter output with regex, detect errors automatically, and run commands in the background with priority queuing. The SSH support handles password and key auth for remote systems, Docker, and WSL. Built-in monitoring tracks system and per-session metrics with configurable alerts. Profile management lets you save connection configs for quick reuse. It's production ready, cross-platform, and requires no native compilation since they dropped the node-pty dependency. Reach for this when you need Claude to orchestrate complex terminal workflows, automate deployments, or run integration tests against CLI tools.

GitHub stars
37
tools
40
transport
STDIO
env var
1
last updated
Oct 5, 2025

Tools

40 tools

Public tool metadata for what this MCP can expose to an agent.

console_create_sessionCreate local or SSH console sessions

Create local or SSH console sessions

No parameter schema in public metadata yet.

console_send_inputSend text input to sessions

Send text input to sessions

No parameter schema in public metadata yet.

console_send_keySend special keys (Enter, Ctrl+C, etc.)

Send special keys (Enter, Ctrl+C, etc.)

No parameter schema in public metadata yet.

console_get_outputGet filtered/paginated output with advanced search

Get filtered/paginated output with advanced search

No parameter schema in public metadata yet.

console_get_streamStream output from long-running processes

Stream output from long-running processes

No parameter schema in public metadata yet.

console_wait_for_outputWait for specific patterns

Wait for specific patterns

No parameter schema in public metadata yet.

console_stop_sessionStop sessions

Stop sessions

No parameter schema in public metadata yet.

console_list_sessionsList all active sessions

List all active sessions

No parameter schema in public metadata yet.

console_cleanup_sessionsClean up inactive sessions

Clean up inactive sessions

No parameter schema in public metadata yet.

console_execute_commandExecute commands with output capture

Execute commands with output capture

No parameter schema in public metadata yet.

console_detect_errorsAnalyze output for errors

Analyze output for errors

No parameter schema in public metadata yet.

console_get_resource_usageGet system resource stats

Get system resource stats

No parameter schema in public metadata yet.

console_clear_outputClear output buffers

Clear output buffers

No parameter schema in public metadata yet.

console_get_session_stateGet session execution state

Get session execution state

No parameter schema in public metadata yet.

console_get_command_historyView command history

View command history

No parameter schema in public metadata yet.

console_get_system_metricsComprehensive system metrics

Comprehensive system metrics

No parameter schema in public metadata yet.

console_get_session_metricsSession-specific metrics

Session-specific metrics

No parameter schema in public metadata yet.

console_get_alertsActive monitoring alerts

Active monitoring alerts

No parameter schema in public metadata yet.

console_get_monitoring_dashboardReal-time dashboard data

Real-time dashboard data

No parameter schema in public metadata yet.

console_start_monitoringStart custom monitoring

Start custom monitoring

No parameter schema in public metadata yet.

console_stop_monitoringStop monitoring

Stop monitoring

No parameter schema in public metadata yet.

console_save_profileSave SSH/app connection profiles

Save SSH/app connection profiles

No parameter schema in public metadata yet.

console_list_profilesList saved profiles

List saved profiles

No parameter schema in public metadata yet.

console_remove_profileRemove profiles

Remove profiles

No parameter schema in public metadata yet.

console_use_profileQuick connect with saved profiles

Quick connect with saved profiles

No parameter schema in public metadata yet.

console_execute_asyncExecute commands asynchronously

Execute commands asynchronously

No parameter schema in public metadata yet.

console_get_job_statusCheck job status

Check job status

No parameter schema in public metadata yet.

console_get_job_outputGet job output

Get job output

No parameter schema in public metadata yet.

console_cancel_jobCancel running jobs

Cancel running jobs

No parameter schema in public metadata yet.

console_list_jobsList all background jobs

List all background jobs

No parameter schema in public metadata yet.

console_get_job_progressMonitor job progress

Monitor job progress

No parameter schema in public metadata yet.

console_get_job_resultGet complete job results

Get complete job results

No parameter schema in public metadata yet.

console_get_job_metricsJob execution statistics

Job execution statistics

No parameter schema in public metadata yet.

console_cleanup_jobsClean up completed jobs

Clean up completed jobs

No parameter schema in public metadata yet.

console_assert_outputAssert output matches criteria

Assert output matches criteria

No parameter schema in public metadata yet.

console_assert_exit_codeAssert exit codes

Assert exit codes

No parameter schema in public metadata yet.

console_assert_no_errorsVerify no errors occurred

Verify no errors occurred

No parameter schema in public metadata yet.

console_save_snapshotSave session state snapshots

Save session state snapshots

No parameter schema in public metadata yet.

console_compare_snapshotsCompare state differences

Compare state differences

No parameter schema in public metadata yet.

console_assert_stateAssert session state

Assert session state

No parameter schema in public metadata yet.

Sponsors

Configuration

LOG_LEVEL

Logging level for console output (error, warn, info, debug, trace)

Readme

Console Automation MCP Server

Model Context Protocol (MCP) server for controlled interaction with local console applications and remote SSH sessions, including output monitoring, error detection, and long-running workflows.

Version License Node

Security status

This server can execute arbitrary commands and open remote SSH sessions. Treat it like a privileged terminal, not a low-risk documentation connector:

  • keep MCP tool approvals enabled for command/session mutations;
  • prefer SSH keys or environment-variable credential references over inline secrets;
  • use a restricted deployment account and a separate production approval step;
  • leave MCP_DEBUG_LOG and MCP_LOG_DIR unset unless diagnostics are explicitly required;
  • leave session persistence disabled unless recovery metadata is explicitly required;
  • install cloud, container, and serial integrations only when needed.

Features


View the full README on GitHub

Details

Repository
github.com/ooples/mcp-console-automation
Category
Automation & Workflows
Package
mcp-console-automation
Transport
STDIO
Registry
MCP registry, active

More from ooples

Related Automation & Workflows MCP servers

View all
1sapientsai avatarPower Automate Mcp Serversapientsai/power-automate-mcp-serverInspect, operate, and author Microsoft Power Automate cloud flows from an agent context.2stars
2br0ski777 avatarCron Parser APIbr0ski777/cron-parser-x402Parse, validate and explain cron expressions. Get next run times. x402 micropayment.0stars
3dailyaiagents-cpu avatarCron Self Healdailyaiagents-cpu/dailyai-osWatcher — surfaces crons in error state0stars
4lazymac2x avatarCron Parserlazymac2x/cron-parser-apiCloudflare Workers MCP server: cron-parser0stars
5rog0x avatarWebhookrog0x/mcp-webhook-toolsSend, validate, debug webhooks for AI agents0stars
6rpgmais avatarn8n MCP Serverrpgmais/mcp-n8nThe most complete MCP server for n8n — 43 tools for workflows, data tables, and more.0stars