Remote Access

You can control remote devices directly from Claude Code by using an MCP server that provides SSH and UART/serial port access. This setup lets you work with devices like Raspberry Pi and other embedded systems as if you were sitting in front of them, all through Claude Code.

How to use

You interact with the MCP server through Claude Code by selecting the remote-access MCP and issuing natural language commands. For SSH tasks, Claude Code will establish an SSH connection to the target, execute commands, and transfer files when needed. For serial operations, Claude Code will list available serial ports, connect to a chosen port, and send or read data in a conversational way. Your sessions are isolated and restart-safe within the MCP server context.

How to install

Prerequisites: you need a working environment where you can run MCP servers and Claude Code integrations. You will clone the MCP server repository, install it, and configure Claude Code to invoke it.

git clone https://github.com/RFingAdam/mcp-remote-access.git
cd mcp-remote-access
uv pip install -e .

Configuration and startup

Add the MCP server to Claude Code so it can start the remote-access service when you request it. You can either add it via the command line or by editing Claude Code’s configuration.

claude mcp add remote-access -- uv run --directory /path/to/mcp-remote-access mcp-remote-access

Or manually add to your Claude Code configuration file (for example, a JSON-like snippet):

{
  "mcpServers": {
    "remote-access": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-remote-access", "mcp-remote-access"]
    }
  }
}

Starting Claude Code

After configuring, restart Claude Code to load the new MCP server configuration.

claude

Usage examples

SSH to a Raspberry Pi: Claude will connect to the target, execute commands, and handle file transfers as needed.

Serial connection to an embedded device: Claude will list available serial ports, connect to the chosen port, and manage data transmission and reception.

Available tools

ssh_connect

Establish an SSH connection to a remote host, authenticating with a password or a key.

ssh_execute

Execute commands on the connected SSH session.

ssh_upload

Upload files to the remote host via SFTP.

ssh_download

Download files from the remote host via SFTP.

ssh_disconnect

Close the SSH connection.

ssh_list_connections

List all active SSH connections.

serial_list_ports

List all available serial ports on the local system or attached devices.

serial_connect

Connect to a specified serial port with given parameters.

serial_send

Send data over the connected serial port and optionally read a response.

serial_read

Read incoming data from the connected serial port.

serial_disconnect

Close the serial port connection.

serial_list_connections

Show active serial port connections.