claude-ssh-mcp

MCP addon for Claude Desktop — gives Claude SSH access to your servers.

Install

With pip (auto-installs Node.js if needed):

pip install claude-ssh-mcp
claude-ssh-mcp

Or with npm:

npx -y claude-ssh-mcp

That's it. Restart Claude Desktop and you're ready.

Usage

Just talk to Claude naturally:

• "Connect to 192.168.1.100 as root with password mypass, call it production"
• "Run ls -la /var/www on production"
• "Upload C:\Users\me\app.zip to /tmp/app.zip on production"
• "Download /var/log/error.log from production"
• "Connect to 10.0.0.5 as deploy with key at C:\Users\me.ssh\id_rsa, name it staging"
• "Transfer /var/log/app.log from production to /tmp/app.log on staging"
• "List my servers"
• "Remove staging"

Features

• Auto-install — one command adds it to Claude Desktop
• Auto-installs Node.js — pip version handles everything
• Servers are saved — connect once, reconnect by name
• SSH keepalive — connections stay alive during long sessions
• Auto-reconnect — recovers from network interruptions
• Auto-update — checks for updates every 2 hours

Saved Servers

When you tell Claude to connect, the server is saved to ~/.mcp-ssh/servers.json. Next time just say "connect to production".

Edit manually if you prefer:

{
  "production": {
    "host": "192.168.1.100",
    "port": 22,
    "username": "root",
    "password": "mypass"
  },
  "staging": {
    "host": "10.0.0.5",
    "port": 22,
    "username": "deploy",
    "privateKeyPath": "C:\\Users\\me\\.ssh\\id_rsa"
  }
}

Tools

Tool	What it does
ssh_connect	Connect to a server (new or saved)
ssh_disconnect	Close a connection
ssh_list_sessions	Show all connections and saved servers
ssh_remove_server	Delete a saved server
ssh_execute	Run a shell command
ssh_upload	Upload a local file (SFTP)
ssh_download	Download a remote file (SFTP)
ssh_transfer	Copy a file between two servers
ssh_list_files	List remote directory contents

Building from Source

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

Then in Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-ssh-server\\build\\index.js"]
    }
  }
}

License

MIT — free and open source.