mcp-ssh

Ssh MCP Server

mcp-ssh brings SSH host discovery, remote commands, and file transfers into Claude Desktop and other MCP clients. It serves users managing remote machines through existing SSH configurations, with tools for connectivity checks and sequential command batches.

Server facts

mcp-ssh

Project

License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
101
Last commit
Data as of

Tags

  • linux
  • mcp
  • ssh

Overview

Existing SSH configurations provide the starting point for mcp-ssh, which exposes remote operations to Claude Desktop and other MCP-compatible clients. Its host listing combines configured aliases with additional known hosts, giving configuration entries priority. Users can inspect a host’s settings and test whether an SSH connection is possible before requesting remote work. Host discovery also reads configurations referenced through Include directives. Operations use the system’s native SSH and SCP programs, drawing on existing connection settings, SSH agents, and identity files.

For remote work, runRemoteCommand executes an individual shell command, while runCommandBatch processes a sequence of commands on the selected host. Separate uploadFile and downloadFile tools move files between local and remote paths. These tools support workflows such as checking a server, running commands, and retrieving application logs within an assistant conversation. The Node.js service communicates over standard input and output. Distribution options include a Claude Desktop extension and npm-based installation; the documented runtime requirements include Node.js 20 or later and installed SSH and SCP clients.

mcp-ssh setup notes

  • mcp-ssh records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers