# SSH MCP Server
An MCP (Model Context Protocol) server that provides SSH access with Warp-like terminal experience. Connect to remote servers, execute commands, transfer files, and manage interactive shell sessions.
## Installation
```bash
npm install -g @kpanuragh/ssh-mcp
```
Or run directly with npx:
```bash
npx @kpanuragh/ssh-mcp
```
## Features
- **SSH Connection Management** - Multiple concurrent connections with session persistence
- **Command Execution** - Run commands with stdout/stderr capture and exit codes
- **SFTP Operations** - Upload, download, and list files on remote servers
- **Interactive Shell** - PTY-based shell sessions for interactive commands
- **Authentication** - Support for both password and SSH key authentication
## MCP Tools
| Tool | Description |
|------|-------------|
| `ssh_connect` | Establish SSH connection to a remote server |
| `ssh_exec` | Execute a command on connected server |
| `ssh_disconnect` | Close an SSH session |
| `ssh_list_sessions` | List all active SSH sessions |
| `sftp_upload` | Upload a file to remote server |
| `sftp_download` | Download a file from remote server |
| `sftp_list` | List files in remote directory |
| `ssh_shell_start` | Start interactive shell session |
| `ssh_shell_send` | Send input to interactive shell |
| `ssh_shell_read` | Read output from interactive shell |
| `ssh_shell_close` | Close interactive shell session |
## Usage with Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": ["@kpanuragh/ssh-mcp"]
}
}
}
```
## Example Workflow
### 1. Connect to a server
```json
{
"tool": "ssh_connect",
"arguments": {
"host": "example.com",
"username": "user",
"password": "password"
}
}
```
Or with SSH key:
```json
{
"tool": "ssh_connect",
"arguments": {
"host": "example.com",
"username": "user",
"privateKeyPath": "/home/user/.ssh/id_rsa"
}
}
```
### 2. Execute commands
```json
{
"tool": "ssh_exec",
"arguments": {
"sessionId": "uuid-from-connect",
"command": "ls -la"
}
}
```
### 3. Transfer files
```json
{
"tool": "sftp_upload",
"arguments": {
"sessionId": "uuid-from-connect",
"localPath": "/local/file.txt",
"remotePath": "/remote/file.txt"
}
}
```
### 4. Interactive shell
```json
{
"tool": "ssh_shell_start",
"arguments": {
"sessionId": "uuid-from-connect"
}
}
```
```json
{
"tool": "ssh_shell_send",
"arguments": {
"sessionId": "uuid-from-connect",
"shellId": "shell-uuid",
"input": "cd /var/log\n"
}
}
```
### 5. Disconnect
```json
{
"tool": "ssh_disconnect",
"arguments": {
"sessionId": "uuid-from-connect"
}
}
```
## License
MIT
