Log inSubmit server
Ssh Client MCP Server logo

Ssh Client MCP Server

Run shell commands and manage persistent tmux sessions on a configured remote host through SSH and MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Ssh Client MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ssh-client-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-client-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y ssh-client-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 6d ago.

Overview

ssh-client-mcp-server MCP server runs locally and gives MCP clients access to shell commands on a configured remote SSH host. It uses stdio transport and accepts connection details through command-line flags, with password, private-key, environment-key, and SSH-agent authentication options. Use it when an agent needs to inspect or operate a reachable Linux, macOS, or OpenSSH-based Windows system. Persistent tmux tools are available for interactive or long-running remote processes when tmux is installed on the host.

Use cases

  • Run shell commands on a remote development host
  • Inspect remote system status through an MCP client
  • Drive long-running processes with tmux sessions
  • Use an SSH agent without exposing private keys to the server

Key features

  • Remote shell execution over SSH
  • Password, key-file, key-environment, and SSH-agent authentication
  • Persistent tmux session controls
  • Cross-platform Node.js runtime support
  • MCP health and capability introspection

Tools4

What Ssh Client MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~63 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · ssh-client-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads244Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed4Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Ssh Client MCP Server works

What ssh-client-mcp-server does

ssh-client-mcp-server MCP server lets an MCP client execute shell commands on one configured remote host through SSH. The primary exec tool returns standard output from the remote command, while standard error is reported as a structured error. The package runs locally on Linux, macOS, or Windows wherever Node.js 22 or later is available.

The server is designed for a single SSH target. Its companion monorepo package, ssh-fleet-mcp-server, handles multi-host configurations, but that is a separate package and is not part of this connector’s single-host behavior.

How it works

An MCP client launches the process and passes the SSH target and authentication settings as command-line arguments. The server establishes access to the configured host and exposes the remote command interface over the stdio MCP transport. The --user option is optional; without it, the local operating-system username is used. The default SSH port is 22.

In addition to remote execution, the server registers introspection endpoints supplied by its underlying framework. soma_health reports uptime, status, and active sessions. soma_capabilities lists registered tools, resources, and prompts. soma_connections reports gateway connection status, although that capability is unused for this connector.

For processes that need to continue between calls, tmux-backed tools can list sessions, send input, read recent pane output, and send control keys. A session is created when needed, and the default session name is agent unless changed with the tmux-session option. The remote machine must have tmux installed.

Setup and configuration

The usual setup is to configure an MCP client to run the published package with npx; a global installation or a source build is also supported. The required connection argument is --host. Authentication can be supplied with --password, a private-key path using --key, a PEM value named by --key-env, or the local SSH agent through --agent=true.

Authentication options are considered in this order: password, key path, key environment variable, then agent. The key path accepts ~, shell-style environment-variable forms, and relative paths. The server validates a configured key during startup, so invalid key material can fail before the first command is executed. If no authentication option is supplied, startup can still complete, but SSH authentication will fail when exec is called.

For agent-based authentication, SSH_AUTH_SOCK must point to a reachable SSH-agent socket. This can include agents exposed by supported desktop password managers. Keep passwords and private keys out of checked-in client configuration files.

Tools and capabilities

  • exec: Run a shell command on the configured remote host and return its output.
  • tmux_list: List live remote tmux sessions.
  • tmux_send: Send text to a tmux session and optionally submit it.
  • tmux_read: Read a recent pane transcript, up to 2,000 lines.
  • tmux_keys: Send control or special keys such as C-c.
  • soma_health, soma_capabilities, and soma_connections: Expose server status, registered MCP capabilities, and connection status.

Limitations and notes

ssh-client-mcp-server MCP server targets one configured SSH host rather than a fleet. Remote command behavior depends on the target shell, account permissions, network reachability, and SSH authentication setup. Tmux features require tmux on the remote host, and full-screen terminal interfaces may not produce clean transcripts; line-oriented programs are better suited to tmux_read.

The package is provided under the MIT License and is not affiliated with or endorsed by an SSH vendor.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ssh Client MCP Server

ssh-client-mcp-server is an MCP server that connects MCP clients to a configured reachable SSH host. Its main tools run remote shell commands with exec, control persistent tmux sessions, and expose health, capability, and connection status through soma_health, soma_capabilities, and soma_connections.

Install it by configuring your MCP client to launch `npx -y ssh-client-mcp-server` with the required `--host` and authentication arguments. You can also install it globally with npm or build it from the repository with pnpm.

Configure authentication with one of `--password`, `--key`, `--key-env`, or `--agent=true`. The server checks these choices in that order. Agent mode uses `SSH_AUTH_SOCK`, while key paths support tilde, environment-variable, and relative-path expansion.

Yes. Cursor is named as a supported MCP client, and the server uses the standard stdio transport. Configure Cursor to launch the package with the same command and arguments used for the SSH host.

Related MCP servers

All in Command Line All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSsh Client MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ssh-client-mcp-server?style=directory)](https://allmcps.com/mcp/ssh-client-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/ssh-client-mcp-server"><img src="https://allmcps.com/api/badge/ssh-client-mcp-server?style=directory" alt="Ssh Client MCP Server on AllMCPs" /></a>