SSH MCP Server
Enables SSH connectivity and remote command execution on Raspberry Pi devices, allowing testing of connections and running commands with stdout, stderr, and exit code responses.
Enables SSH connectivity and remote command execution on Ubuntu servers, allowing testing of connections and running commands with stdout, stderr, and exit code responses.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SSH MCP Server test connection to my raspberry pi"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SSH MCP Server
A Model Context Protocol (MCP) server that enables SSH connectivity and remote command execution. This server can run locally to access private networks or via Smithery for public servers.
Features
ssh_test_connection: Tests connectivity to the configured host and returns hostname
ssh_run: Executes commands remotely and returns stdout, stderr, and exit code
Related MCP server: SSH MCP Server
Installation Methods
Method 1: From Source (For Development)
Best for developers who want to modify the code or contribute to the project.
Clone and build:
git clone https://github.com/lgariv/ssh-mcp
cd ssh-mcp
npm install
npm run buildAdd to your MCP client config:
{
"mcpServers": {
"ssh-mcp": {
"command": "node",
"args": ["path/to/ssh-mcp/dist/index.js"],
"env": {
"SSH_HOST": "192.168.1.100",
"SSH_PORT": "22",
"SSH_USERNAME": "ubuntu",
"SSH_PASSWORD": "your-password"
}
}
}
}Method 2: Via NPM Package (Recommended for Local Networks)
Best for accessing servers on your local network (LAN) or private IPs. Runs on your machine.
Add to your MCP client config:
{
"mcpServers": {
"ssh-mcp": {
"command": "npx",
"args": ["-y", "@lgariv/ssh-mcp@latest"],
"env": {
"SSH_HOST": "10.0.0.116",
"SSH_PORT": "22",
"SSH_USERNAME": "admin",
"SSH_PASSWORD": "your-password"
}
}
}
}Benefits:
No installation required
Always uses the latest version
Can access local network resources (192.168.x.x, 10.x.x.x, etc.)
Credentials stay on your machine
Method 3: Via Smithery (For Public Servers Only)
Best for accessing publicly accessible SSH servers. Runs on Smithery's infrastructure.
⚠️ Important: This method only works with publicly accessible servers. It cannot access private IPs or LAN resources.
Add to your MCP client config:
{
"mcpServers": {
"ssh-mcp": {
"type": "http",
"url": "https://server.smithery.ai/lgariv/ssh-mcp/mcp",
"config": {
"sshHost": "public.example.com",
"sshPort": 22,
"sshUsername": "ubuntu",
"sshPassword": "your-password"
}
}
}
}Configuration
All methods require these environment variables or config parameters:
Parameter | Description | Default |
| Target SSH server IP/hostname | Required |
| SSH port number | 22 |
| SSH username | Required |
| SSH password | Required |
Use Cases by Method
Use Case | Recommended Method |
Local home lab servers | Method 2 (NPM) |
Raspberry Pi on LAN | Method 2 (NPM) |
Local VMs or containers | Method 2 (NPM) |
Development and testing | Method 1 (Source) |
Cloud VPS with public IP | Method 3 (Smithery) |
Public web servers | Method 3 (Smithery) |
Security Notes
Methods 1 & 2: Credentials are stored locally in your MCP configuration
Method 3: Credentials are sent to Smithery's servers (use only with public servers)
Always use strong passwords and consider SSH keys for production use
Ensure your MCP configuration file has appropriate permissions
Development
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run built version
npm startLicense
ISC
Author
lgariv
Available Tools
2 toolsssh_runRun Remote CommandB
Runs a non-interactive command remotely over SSH and returns stdout, stderr, and exit code
Inputs: command (required).
ssh_test_connectionTest SSH ConnectionB
Attempts to connect to the configured SSH host and returns the remote hostname
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: ssh_run executes commands and returns results, while ssh_test_connection only tests connectivity and returns hostname. There is no overlap or ambiguity between them.
Both tools follow a consistent 'ssh_' prefix pattern with clear verb_noun naming (ssh_run and ssh_test_connection). The naming is predictable and follows the same convention throughout.
With only 2 tools, this server feels severely under-scoped for SSH operations. While the tools cover basic connectivity and command execution, there are many obvious missing SSH functionalities like file transfer, session management, or interactive operations.
For an SSH server, the surface is significantly incomplete. There's no file transfer (scp/sftp), no interactive shell capability, no key management, no port forwarding, and no session persistence. Agents will hit dead ends trying to perform common SSH tasks beyond basic command execution.
Related MCP Connectors
Manage servers through SSH.
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Manage remote servers, SSH terminals, files, databases and proxies with scoped access and approvals.
SSH client, server management and one remote MCP URL for your machines, with human approvals.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables secure SSH connections to multiple remote servers with support for command execution, file transfers (SFTP), directory listing, and both password and key-based authentication.7MIT
- AlicenseAqualityDmaintenanceEnables remote server management through SSH and SFTP, supporting command execution, file transfers, and interactive shell sessions. It allows for multiple concurrent connections using either password or SSH key authentication.1121 npm5MIT
- FlicenseBqualityDmaintenanceEnables secure SSH connections to remote servers for executing shell commands and managing active sessions. It supports authentication via passwords or private keys and provides optional host-based access control.4-
- FlicenseNot gradedqualityDmaintenanceEnables remote server management via SSH, including command execution, file transfer (SFTP), and interactive shell sessions, with support for multiple hosts.-