What It Does
ssh-mcp (based on mcp-ssh-manager) is an MCP server that enables Claude Code to manage multiple SSH connections. Execute commands, transfer files, manage databases, create backups, monitor health, and automate DevOps tasks across your servers — directly from your AI assistant.
Tool Groups (37 tools in 6 groups)
- Core (5) — list servers, execute commands, upload, download, sync files
- Sessions (4) — persistent SSH sessions that maintain shell context across commands
- Monitoring (6) — health checks (CPU, RAM, disk), service status, process manager, alerts
- Backup (4) — create/list/restore/schedule automated backups for MySQL, PostgreSQL, MongoDB, and files
- Database (4) — safe dumps, imports, schema exploration, read-only queries with SQL injection prevention
- Advanced (14) — deployment with permissions, sudo execution, SSH tunnels, server groups, aliases, hooks, profiles
Key Features
- Multi-server management — Unlimited SSH servers from a single interface
- Flexible auth — Password, SSH key, ssh-agent, and passphrase-protected keys
- ProxyJump / Bastion — Connect through jump hosts with chained multi-hop support
- Windows support — Full OpenSSH for Windows compatibility
- Context optimization — Enable only the tool groups you need (92% context reduction in minimal mode)
Quick Start
# Install from npm
npm install -g mcp-ssh-manager
# Or clone from Gitea
git clone https://git.mokoconsulting.tech/MokoConsulting/ssh-mcp.git
cd ssh-mcp
npm install
Claude Code Registration
claude mcp add ssh-manager node /path/to/ssh-mcp/src/index.js
Server Configuration
Configure servers in your .env file:
SSH_SERVER_PRODUCTION_HOST=prod.example.com
SSH_SERVER_PRODUCTION_USER=admin
SSH_SERVER_PRODUCTION_KEYPATH=~/.ssh/id_rsa
SSH_SERVER_PRODUCTION_DEFAULT_DIR=/var/www/html
Source & License
MIT License. Repository: MokoConsulting/ssh-mcp