# MCP Ssh Manager

> MCP Ssh Manager is an open-source MCP server for developer tools. SSH for AI agents with command approval, a credential vault and an audit trail. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/bvisible/mcp-ssh-manager
- **MCP Registry name:** io.github.bvisible/mcp-ssh-manager
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `ssh_sync`: Syncs files between machines using rsync.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcp-ssh-manager
