mcp-ssh

Overview

mcp-ssh is a comprehensive MCP (Model Context Protocol) server that enables AI models to manage SSH connections and execute remote commands. It supports connection management, command execution, tmux session handling, file operations, and process monitoring. The server features intelligent command execution with blocking detection, tmux integration for persistent sessions, and robust error recovery mechanisms.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• create_ssh_connection

  Create a new SSH connection to a remote server

  Try:Please help me create a new SSH connection to my serverTry:Create SSH connection to 192.168.1.100 with user admin
• execute_command

  Execute a command on a connected SSH server

  Try:Please run 'ls -la' on the serverTry:Execute 'df -h' to check disk usage
• execute_composite_command

  Execute multiple commands connected by && or ;

  Try:Run 'cd /var/log && ls -la' on the serverTry:Execute 'sudo apt update && sudo apt upgrade'
• create_tmux_session

  Create a new tmux session on the remote server

  Try:Create a new tmux session named 'monitoring'Try:Start a tmux session and run top command
• list_tmux_sessions

  List all active tmux sessions on the remote server

  Try:Show me all active tmux sessionsTry:List tmux sessions with their status
• send_tmux_keys

  Send key sequences to a tmux session

  Try:Send 'ls -la' to the monitoring tmux sessionTry:Type 'exit' in the development session
• capture_tmux_output

  Capture output from a specific tmux session

  Try:Get the output from the monitoring sessionTry:Show what's currently displayed in the production session
• upload_file

  Upload a file to the remote server via SSH

  Try:Upload local backup.zip to /tmp/ on the serverTry:Send config.json to /etc/app/config
• download_file

  Download a file from the remote server to local

  Try:Download /var/log/syslog to my local machineTry:Get the latest backup file from the server
• read_file

  Read the contents of a file on the remote server

  Try:Show me the content of /etc/nginx/nginx.confTry:Read the last 100 lines of /var/log/syslog
• detect_blocking_processes

  Detect blocking processes on the remote server

  Try:Check if there are any blocking processesTry:Find processes that might be causing delays
• list_ssh_connections

  List all configured SSH connections

  Try:Show me all my SSH connectionsTry:List available SSH profiles

Comparable tools

Installation

git clone https://github.com/shuakami/mcp-ssh.git
cd mcp-ssh
npm install
npm run build

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "python3",
      "args": ["/path/to/mcp-ssh/bridging_ssh_mcp.py"]
    }
  }
}

FAQ

What authentication methods does mcp-ssh support?

mcp-ssh supports both password authentication and SSH key authentication. It can handle various key formats and secure credential storage.

How does it handle long-running commands?

The server implements intelligent blocking detection, automatically detecting and waiting for blocking processes. It supports timeouts and provides options for force execution.

Compare mcp-ssh with