danielecr avatar

Realssh Mcp

danielecr/realssh-mcp

This takes the pragmatic approach of shelling out to your system's ssh binary instead of reimplementing the protocol in Node. That means your existing ssh-agent sessions, ProxyCommand directives, jump hosts, and ~/.ssh/config aliases all work without translation. You get two tools: ssh_execute for running commands and ssh_test for connectivity checks. Both return stdout, stderr, and exit codes. Useful when you need Claude to run remote diagnostics, check service status, or gather system metrics from production boxes without building API wrappers around everything. Commands respect your local SSH configuration, so if you've already got bastion routing and key management set up, it just works.

tools
2
transport
STDIO
last updated
Apr 24, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

ssh_executeExecute a command on a remote server via SSH.

Execute a command on a remote server via SSH.

No parameter schema in public metadata yet.

ssh_testTest SSH connectivity to a remote host (runs `echo ok` and checks the response).

Test SSH connectivity to a remote host (runs `echo ok` and checks the response).

No parameter schema in public metadata yet.

Sponsors

Readme

SSH Real MCP Server

A Model Context Protocol (MCP) server that enables SSH remote command execution by delegating entirely to the system ssh binary. This means ssh-agent, ProxyCommand, ~/.ssh/config, jump hosts, and every other OS-level SSH feature work out of the box — no Node.js crypto, no native addons.

How it works

Instead of implementing the SSH protocol in Node.js, this server spawns ssh as a child process and pipes the output back to the MCP client. Authentication, key discovery, and connection routing are handled by your OS, exactly as if you ran ssh yourself in a terminal.

Requirements: ssh must be installed and available in PATH (standard on macOS and Linux).

Features


View the full README on GitHub

Details

Repository
github.com/danielecr/realssh-mcp
Package
@danielecr/realssh-mcp
Transport
STDIO
Registry
MCP registry, active