sshmcp
Provides persistent shell sessions over SSH backed by tmux, enabling stateful command execution across calls with preserved working directory and environment.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sshmcpconnect to myserver.com and run 'df -h'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Tool | Description |
| Connect to a host via SSH (password, key, or agent) |
| Run a command in the persistent shell |
| Read recent terminal output |
| Upload a local file via SFTP |
| Download a remote file via SFTP |
| Write content to a remote file |
| List all active sessions |
| Switch active session |
| Close a session |
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")This server cannot be deployed
Maintenance
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Termalin's hosted MCP server. Claude, ChatGPT or any MCP client runs commands, moves files over SFTP, queries databases and reads server metrics and monitoring alerts on your servers, keylessly through Termalin Connectors: no SSH key is handed over and no inbound port is opened. Per-host command policy and an audit log. Needs a termal.in Pro or Team account (new accounts start with a 14-day Pro trial).
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseAqualityCmaintenanceAn SSH MCP server that enables users to connect to and manage remote servers directly from Claude Code. It provides tools to execute commands, monitor connection status, and dynamically manage server configurations through natural language.10121 npm6MIT
- AlicenseAqualityAmaintenanceSSH automation MCP server that enables Claude and ChatGPT to execute commands, manage files, install packages, and control services on remote servers over SSH — supporting password, key, and agent authentication.331,267 npm4MIT
- AlicenseNot gradedqualityDmaintenanceA local MCP server that proxies file and shell tools (Read, Write, Edit, Bash, etc.) to a remote Linux host over SSH, enabling MCP clients like Claude Code to operate on remote codebases.MIT
- AlicenseNot gradedqualityAmaintenanceAn MCP server enabling Claude to execute commands on multiple remote servers via SSH and transfer large files (40GB+) with resume support via SFTP.7 npm17MIT