ssh-utils

What is ssh-utils?

ssh-utils is a Model Context Protocol (MCP) server for executing terminal commands on a remote server via SSH. It is designed for use with Roo Code or any MCP-compatible client, using key-based authentication.

How to use ssh-utils?

Place the configuration file (ssh-utils-servers.json) in the current working directory, workspace root, or the global config directory (~/.config/ssh-utils/). Then invoke the execute_ssh_command tool from an MCP client, specifying the command and optionally overriding connection parameters.

Key features of ssh-utils

• Executes remote commands via SSH over MCP.
• Supports only key-based authentication (no passwords).
• Configurable multiple server profiles in one file.
• Connection parameters can be overridden per command.
• Compatible with Roo Code and any MCP client.
• Configuration file loads from several standard locations.

Use cases of ssh-utils

• Run system commands on a remote server from your editor.
• Automate deployment or maintenance tasks via an MCP client.
• Manage multiple servers using different profiles in one config.

FAQ from ssh-utils

What authentication method does ssh-utils use?

Only key-based SSH authentication is supported; password-based authentication is explicitly prohibited for security.

Where should I place the configuration file?

The file ssh-utils-servers.json can go in the current working directory, the workspace root, or the global config directory ~/.config/ssh-utils/.

Can I use multiple server profiles?

Yes, the configuration file supports multiple profiles. The first profile is used by default, or you can specify a profile by name when invoking the tool.

How do I override connection settings for a command?

Any tool arguments such as user, host, or server will override the corresponding values from the configuration file for that command.

What if no private key path is provided in the config?

The privateKeyPath field is optional. If omitted, the SSH client will use the default key discovery mechanism (e.g., keys loaded in the SSH agent).