Skip to content
MCP server

MCP Ssh Manager

SSH for AI agents with command approval, a credential vault and an audit trail

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
4.2.0
Listing updated
today

Similar MCP servers

About MCP Ssh Manager

MCP Ssh Manager is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README frames this as a way to hand an agent a shell on real machines while still seeing what it does and being able to refuse. It adds an optional control plane, opened with ssh-manager control or a desktop app, where activity can be watched and, if enabled per server, approvals required. The engine also runs headless from an .env file, a TOML file or process variables, and servers can be set to readonly or restricted mode to limit what the agent may run.

The 37 tools cover running commands, moving files, taking MySQL, PostgreSQL and MongoDB backups with a retention policy, checking CPU, memory and disk health, tailing logs, opening port-forward tunnels and running one command across a group of servers in sequence or in parallel. File sync uses rsync, and password-auth sync needs sshpass.

Install it with npm, Homebrew, from source or as a signed macOS desktop build; Windows and Linux builds are unsigned. It needs Node 18 or later and works with Claude Code, Claude Desktop, OpenAI Codex or any MCP client. Version 4 tightens SSH host-key verification, so the README points to a migration guide before upgrading.

Install

Run in a terminal

claude mcp add mcp-ssh-manager -- npx -y mcp-ssh-manager

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ssh-manager"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ssh-manager"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-ssh-manager": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-ssh-manager"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ssh-manager"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ssh-manager"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SSH_CONFIG_PATHPath to a TOML file holding the server definitions. Defaults to ~/.codex/ssh-config.toml. Each server can set MODE to readonly or restricted to constrain what the agent may run.
  • SSH_ENV_PATHPath to a .env file declaring servers as SSH_SERVER_<NAME>_HOST, _USER, _KEYPATH and friends. Defaults to a .env next to the package.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

ssh_sync
Syncs files between machines using rsync.

What it does

Approval and audit
Optionally require approval and keep an audit trail of what the agent ran.
Server health checks
Report CPU, memory, disk, load and top processes in one call.
Database backups
Create timestamped MySQL, PostgreSQL or MongoDB dumps with retention.
Server groups
Run one command across tagged servers in sequence or in parallel.
File transfer and sync
Move files over SFTP and sync directories with rsync.
Port-forward tunnels
Open a local tunnel to a remote database.
Read-only modes
Mark a server readonly or restricted to limit commands.

Good for

  • Check why a production server is slow
  • Back up a database before a deploy
  • Tail an nginx error log on staging
  • Push a build folder to a server and restart a service
  • Find which servers in a group are low on disk

Pricing

Open source

Install from npm or Homebrew; desktop builds are on GitHub releases.

MCP Ssh Manager FAQ

Which clients does it work with?

Claude Code, Claude Desktop and OpenAI Codex are named, along with any MCP client.

How many tools does it have?

The README says 37.

What does it need to run?

Node 18 or later, plus rsync for sync and sshpass only for password-based sync.

Can I limit what the agent can do?

Yes. A server can be set to readonly or restricted mode, and approval can be enabled per server.

Is the Windows app signed?

The README says not yet; it is checked against a published SHA-256.

Is MCP Ssh Manager free?

Yes. MCP Ssh Manager is open source, so you can use and self-host it for free.

How do I add MCP Ssh Manager to Claude Code?

Run this command in your terminal: claude mcp add mcp-ssh-manager -- npx -y mcp-ssh-manager

What are the best alternatives to MCP Ssh Manager?

The closest alternatives to MCP Ssh Manager are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers