MokoSSH MCP Server

Details
Category: Getting Started
  • Applicable Software: MokoSSH MCP
  • Min Version Number: 02.08.00
  • Max Version Number: Not Applicable

What It Does

mcp-mokossh (a MokoConsulting fork of mcp-ssh-manager) enables Claude Code to manage multiple SSH connections - execute commands, transfer files, manage databases, create backups, monitor health, and automate DevOps tasks directly from your AI assistant.

Tool Groups (37+ tools)

ssh_execute, ssh_upload, ssh_download, ssh_sync, ssh_list_servers.

Persistent SSH sessions that maintain shell context across commands - start, send, list, and close.

Health checks (CPU, RAM, disk, network, load), service status, process manager, real-time monitor, log tailing, and alerts.

Create, list, restore, and schedule automated backups for MySQL, PostgreSQL, MongoDB, and files.

Dumps, imports, list databases/tables, and read-only SELECT queries.

Deployment, sudo execution, SSH tunnels, server groups, aliases, hooks, profiles, and key management.

Key Features

  • Multi-server management - unlimited SSH servers from one 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 (~3.5k tokens in minimal mode vs ~43.5k for all tools)

Install

npm install -g @mokoconsulting/mcp-mokossh

Or clone from MokoGIT:

git clone https://git.mokoenterprises.us/MokoConsulting/mcp-mokossh.git
cd mcp-mokossh
npm install

Server Configuration

Configure servers in a .env file (searched at $SSH_ENV_PATH → ~/.ssh-manager/.env → ./.env):

SSH_SERVER_PRODUCTION_HOST=192.168.1.100
SSH_SERVER_PRODUCTION_USER=deploy
SSH_SERVER_PRODUCTION_KEYPATH=~/.ssh/id_ed25519
SSH_SERVER_PRODUCTION_PORT=22

Claude Code Registration

claude mcp add -s user mokossh -- mcp-mokossh

Source & License

MIT License. Repository: MokoConsulting/mcp-mokossh

Hits: 146