# mcp-ssh-manager

This MCP server lets an agent work with SSH connections, remote commands, files, and databases. Per-server access modes limit what it can do.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 518
- Author: bvisible
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bvisible/mcp-ssh-manager
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-ssh-manager

## What it does

\`mcp-ssh-manager` connects Claude Code to multiple SSH servers. An agent can run remote commands, transfer files, work with databases, create backups, check server health, and handle DevOps tasks from the assistant.

Each server can use `unrestricted`, `readonly`, or `restricted` access. `readonly` refuses mutating tools, while `restricted` accepts only commands that match an allow pattern and avoid a deny pattern. Database queries are limited to read-only `SELECT` operations, and a changed host key is refused.

\`unrestricted` is the default, so set an explicit boundary for a production server. Claude Code installs it with `npx`; `SSH_CONFIG_PATH` and `SSH_ENV_PATH` can be passed when the SSH configuration uses specific paths.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SSH_CONFIG_PATH`, `SSH_ENV_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SSH_CONFIG_PATH=<SSH_CONFIG_PATH> --env SSH_ENV_PATH=<SSH_ENV_PATH> --transport stdio mcp-ssh-manager -- npx -y mcp-ssh-manager
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-ssh-manager --env SSH_CONFIG_PATH=<SSH_CONFIG_PATH> --env SSH_ENV_PATH=<SSH_ENV_PATH> -- npx -y mcp-ssh-manager
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-ssh-manager": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-ssh-manager"
            ],
            "env": {
                "SSH_CONFIG_PATH": "<SSH_CONFIG_PATH>",
                "SSH_ENV_PATH": "<SSH_ENV_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-ssh-manager": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-ssh-manager"
            ],
            "env": {
                "SSH_CONFIG_PATH": "<SSH_CONFIG_PATH>",
                "SSH_ENV_PATH": "<SSH_ENV_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SSH_CONFIG_PATH=<SSH_CONFIG_PATH> -e SSH_ENV_PATH=<SSH_ENV_PATH> mcp-ssh-manager npx -y mcp-ssh-manager
```
Replace <…> with your own values

## When to use it
- run commands on remote SSH servers
- transfer files to and from a server
- check remote server health
- create backups over SSH
- run read-only database queries

## Example prompts
- Check the remote server health and report any problems.
- Transfer this file to the SSH server and verify the result.
- Run a read-only database query without changing any data.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23643
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17160
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md