SSH Tools

You run an MCP SSH Tools Server to centrally manage multiple remote hosts via SSH, including file transfers and remote command execution. This server is configured through MCP, allowing you to start, monitor, and control remote machines from a single place with secure, scriptable interactions.

How to use

Connect to the MCP SSH Tools Server from your MCP client and start managing your remote hosts. You can execute remote commands, transfer files (including directories), and inspect remote directories. All interactions are performed through the server’s MCP endpoints, so you don’t need to log in to each host individually.

Typical workflows include:

• Add a remote host configuration to the server so you can execute commands against that host.

• Run a command on a remote host to perform maintenance or gather data.

• Upload or download files and directories to or from a remote host, with recursive directory support.

• List contents of a remote directory to verify structure before transfers.

If you need to test connectivity, start with a quick connection test to ensure the server can reach your SSH endpoints, then proceed with operations.

How to install

Prerequisites: you need Python 3.13 or newer and a tool that can run MCP-based servers.

Step 1: Install Python 3.13+ using your preferred method, then ensure the python and pip commands are available in your shell.

Step 2: Install the MCP client components used by this server.

Step 3: Install additional dependencies required by the server for SSH and HTTP interactions.

Step 4: (Optional) Create a virtual environment to isolate dependencies.

配置与运行

Configure the MCP SSH Tools Server by providing a JSON configuration that defines your MCP server entries and the SSH connection settings.

{
  "mcpServers": {
    "ssh_sun": {
      "command": "uv",
      "args": [
        "--directory",
        "F:\\仓库\\产品\\mcp-server-ssh-tools",
        "run",
        "main.py"
      ],
      "env": {
        "SSH_IP": "192.168.2.127",
        "SSH_USER": "root",
        "SSH_PASSWORD": "123456",
        "SSH_PORT": "22"
      }
    }
  }
}

注意事项与安全

• 使用强密码或密钥认证来保护远程主机。- 将服务器放在受信任的网络环境中，并对访问进行适当的权限控制。- 定期更新依赖并对敏感操作启用审计日志。

Available tools

execute

Executes a remote command on a configured SSH target and returns the output.

download_file

Downloads a file or directory from a remote host, with support for recursive directory transfers.

upload_file

Uploads a local file or directory to a remote host, including recursive directory uploads.

list_directory

Lists the contents of a remote directory for inspection before transfers.

test_connection

Tests connectivity to the configured SSH servers to verify reachability and credentials.