# ssh MCP server

> Allows AI assistants to execute shell commands, transfer files via SFTP, and manage remote server fleets through SSH.

- Repository: https://github.com/blackaxgit/ssh-mcp
- Page: https://hostedmcp.org/servers/blackaxgit/ssh-mcp
- Transport: —
- Stars: 6
- License: MPL-2.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SSH_MCP_CONFIG` | no | no |  |
| `SSH_MCP_TRANSPORT` | no | no |  |

## Tools (6)

- `list_servers`
- `list_groups`
- `execute`
- `execute_on_group`
- `upload_file`
- `download_file`

## FAQ

### How does the server handle authentication for remote connections?

It reads connection details from your existing ~/.ssh/config file, so no credentials need to be stored in the MCP configuration.

### Can I preview commands before they are executed?

Yes, you can use the dry_run feature to see which server, command, working directory, and timeout would be used without actually connecting.

### Is there a way to restrict where files are uploaded or downloaded?

Yes, SFTP transfers are confined to a specific directory defined by the transfer_root setting or the SSH_MCP_TRANSFER_ROOT environment variable.

### What is the correct package name to install via pip?

You should install blc-ssh-mcp, as the name ssh-mcp on PyPI belongs to an unrelated project.