ezssh-mcp

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

Installation

From npm (Recommended)

npm install -g ezssh-mcp

From Source

git clone https://github.com/laomeifun/ezssh-mcp.git
cd ezssh-mcp
npm install
npm run build

Quick Start

1. Run as MCP Server

ezssh-mcp
# or
npx ezssh-mcp

2. 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
ssh_list_hosts	List available SSH hosts from config
ssh_execute	Execute commands on one or more hosts
ssh_transfer	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_PATH	SSH config file path	~/.ssh/config
SSH_KNOWN_HOSTS_PATH	known_hosts file path	~/.ssh/known_hosts
SSH_AUTH_SOCK	SSH Agent socket path	System default
SSH_TIMEOUT	Connection timeout (ms)	30000
SSH_STRICT_HOST_KEY	Strict host key checking	false
SSH_MAX_CONCURRENCY	Max concurrent connections	10

Development

# Install dependencies
npm install

# Development mode (watch)
npm run dev

# Build
npm run build

# Type check
npm run typecheck

# Run tests
npm test

License

MIT