Adremote

SSH remote access for Claude Code through MCP.

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nqmn-adremote-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/ssh_mcp_server.py"
      ]
    }
  }
}

You can remotely manage Linux servers and execute commands securely by connecting to an SSH-based MCP server. This setup lets you run commands, transfer files, and monitor health from your Claude environment, all through MCP to your remote host.

How to use

Connect to a remote server via MCP to run shell commands, transfer files with SFTP, and manage multiple servers from a single client. You can perform common tasks like listing directories, uploading or downloading files, and initiating long-running processes on the remote host. Use natural language prompts to instruct Claude to perform actions such as connecting to a server, listing files, transferring data, or running commands.

How to install

pip install -r requirements.txt

Configure the MCP client to load the SSH remote server. Add the following MCP config snippet to your Claude Desktop/Claude Code setup where MCP configurations are stored.

{
  "mcpServers": {
    "ssh_remote": {
      "command": "python",
      "args": ["/absolute/path/to/ssh_mcp_server.py"]
    }
  }
}

Additional configuration and setup

After configuring the MCP client, restart Claude Desktop or Claude Code to apply changes. Then you can start interacting with your remote server through natural language prompts.

Security and notes

The setup supports password and SSH key authentication and enforces connection timeouts. Host key acceptance is automatic to streamline first-time connections, so ensure you trust the remote host before connecting.

Available tools

connect

Establishes a new MCP connection to a remote host over SSH and prepares the session for subsequent commands.

executeCommand

Runs a shell command on the connected remote server and returns stdout, stderr, and exit status.

transferFiles

Performs file transfers between the local client and the remote server using SFTP, supporting upload and download operations.

manageConnections

Manages multiple SSH sessions, switching focus, listing active connections, and handling disconnections.

healthMonitor

Monitors the health status of remote connections, including timeouts and connectivity checks to ensure reliable operation.