sshmcp

A stateful SSH MCP server for Claude Code. Gives Claude persistent shell sessions over SSH — commands preserve working directory, environment variables, and state across calls.

Features

• Stateful sessions: tmux-backed shells that persist cwd, env, shell state

• Multiple sessions: connect to multiple hosts simultaneously, switch between them

• File operations: upload, download, and write files via SFTP

• Output management: automatic truncation with head/tail preservation

• Background processes: supports & for long-running commands

Related MCP server: mcp-ssh-tool

Install

pip install -e .

Claude Code config

Add to ~/.claude/claude_desktop_config.json or your MCP settings:

{
  "mcpServers": {
    "ssh": {
      "command": "sshmcp",
      "args": []
    }
  }
}

Tools

Usage

Once configured, Claude can:

ssh_connect(host="myserver.com", username="user", key_path="~/.ssh/id_ed25519")
ssh_exec(command="cd /opt/app && cat config.yaml")
ssh_exec(command="grep -r 'ERROR' /var/log/app/")  # still in /opt/app context
ssh_upload(local_path="./exploit.py", remote_path="/tmp/exploit.py")