ezssh-mcp
Allows using 1Password as an SSH agent for authentication when connecting to SSH hosts.
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., "@ezssh-mcp list all available SSH hosts"
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.
ezssh-mcp
Easy SSH MCP Server - Execute commands and transfer files via SSH with AI assistance.
Features
🖥️ Cross-platform: Linux, macOS, Windows
🔑 SSH Agent support: System SSH Agent, 1Password, Windows OpenSSH
📋 Auto-discovery: Reads hosts from
~/.ssh/config⚡ Concurrent execution: Run commands on multiple hosts simultaneously
📁 File transfer: Upload/download via SFTP
🔗 MCP Resources: SSH hosts exposed as resources for AI access
🤖 Multi-AI compatible: Works with Claude, ChatGPT, Gemini and other MCP-compatible clients
Related MCP server: SSH MCP Server
Installation
From npm (Recommended)
npm install -g ezssh-mcpFrom Source
git clone https://github.com/laomeifun/ezssh-mcp.git
cd ezssh-mcp
npm install
npm run buildQuick Start
1. Run as MCP Server
ezssh-mcp
# or
npx ezssh-mcp2. Configure with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": ["-y", "ezssh-mcp"]
}
}
}Or if installed globally:
{
"mcpServers": {
"ssh": {
"command": "ezssh-mcp"
}
}
}Tools
Tool | Description |
| List available SSH hosts from config |
| Execute commands on one or more hosts |
| Upload/download files via SFTP |
ssh_execute
Execute commands on multiple hosts concurrently:
{
"hosts": ["web1", "web2", "web3"],
"command": "uptime"
}Direct connection (without SSH config):
{
"hosts": ["192.168.1.100"],
"command": "uptime",
"username": "root",
"password": "your-password",
"port": 22
}ssh_transfer
Upload files:
{
"direction": "upload",
"hosts": ["web1", "web2"],
"localPath": "./dist/app.zip",
"remotePath": "/opt/app/app.zip"
}Download files (with {host} placeholder for multiple hosts):
{
"direction": "download",
"hosts": ["web1", "web2"],
"localPath": "./logs/{host}.log",
"remotePath": "/var/log/app.log"
}Resources
SSH hosts are exposed as MCP resources with URI format ssh://<host-name>.
Environment Variables
Variable | Description | Default |
| SSH config file path |
|
| known_hosts file path |
|
| SSH Agent socket path | System default |
| Connection timeout (ms) |
|
| Strict host key checking |
|
| Max concurrent connections |
|
Development
# Install dependencies
npm install
# Development mode (watch)
npm run dev
# Build
npm run build
# Type check
npm run typecheck
# Run tests
npm testLicense
MIT
Available Tools
3 toolsssh_executeA
Execute a command on one or more SSH hosts. Runs concurrently on multiple hosts and returns results from each.
Inputs: hosts (required), command (required), port, timeout, +3 more.
ssh_list_hostsA
List all available SSH hosts from ~/.ssh/config. Returns host names, addresses, users, and connection details.
Inputs: no named parameters.
ssh_transferB
Transfer files between local machine and remote SSH hosts. Supports upload to multiple hosts or download from multiple hosts.
Inputs: hosts (required), direction (required), localPath (required), remotePath (required), +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct SSH operation: listing hosts, executing commands, and transferring files. There is no overlap in their purposes, making selection unambiguous.
All tools share the 'ssh_' prefix, but while 'ssh_list_hosts' and 'ssh_transfer' follow a verb_noun pattern, 'ssh_execute' lacks an explicit object. Still, the names are predictable and readable.
Three tools is on the lean side, but they cover the most common SSH operations well. The count is reasonable for a focused SSH toolkit.
The set covers listing, executing, and transferring, which form a solid core. Missing host management is a minor gap since hosts are typically configured in files.
Maintenance
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.
Your agents' cloud for individuals and teams. Search, execute, packages, jobs, and credentials.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables remote file operations and command execution across multiple machines via SSH. Supports reading files, listing directories, and running commands on any host configured in your SSH config.-
- 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
- AlicenseNot gradedqualityDmaintenanceEnables executing commands on remote SSH hosts, with full support for bastion/jump hosts and ~/.ssh/config, plus Slurm job management and rsync.4MIT
- AlicenseNot gradedqualityDmaintenanceEnables SSH command execution, file uploads/downloads, and multi-server management with zero-config inline credentials, supporting async jobs and AI-readable output.2AGPL 3.0