MCP 服务器

claude-ssh-server

Enables direct SSH connections with IP, username, and password without any config files, allowing Claude to execute commands on any SSH server on demand.

README

Claude SSH Server

Direct SSH connections with IP/username/password - no config required!

This MCP server enables Claude to connect to any SSH server on-demand using just IP address, username, and password. No SSH config files needed!

🚀 Key Feature

Unlike traditional SSH MCP servers that require pre-configured hosts in ~/.ssh/config, Claude SSH Server supports ad-hoc connections with credentials passed directly in each request.

📦 Installation

NPM Global Install

npm install -g claude-ssh-server

Local Install

cd claude-ssh-server
npm install
npm run build

🔧 Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "claude-ssh": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ssh-server"
      ]
    }
  }
}

🎯 Usage

Direct Connection (New!)

Connect to any SSH server without pre-configuration:

{
  "tool": "direct_exec",
  "host": "10.100.100.53",
  "username": "mtusa",
  "password": "your-password",
  "command": "ls -la",
  "port": 22,  // optional, defaults to 22
  "timeout": 60000  // optional, defaults to 60000ms
}

Traditional CLI Mode

You can still use the traditional mode with CLI arguments:

claude-ssh-server --host=10.100.100.53 --user=mtusa --password=mypass

Then use the exec tool (credentials from CLI args).

🛠️ Available Tools

`direct_exec` (Recommended)

Execute commands with credentials provided per-request:

host: SSH server IP or hostname
username: SSH username
password: SSH password (optional if using privateKey)
privateKey: SSH private key content (optional if using password)
command: Command to execute
port: SSH port (default: 22)
timeout: Timeout in ms (default: 60000)

`exec` (Legacy)

Execute commands using CLI-configured credentials:

command: Command to execute

🔒 Security Notes

Credentials are passed per-request and not stored
Supports both password and private key authentication
Connection timeout protection (default 60s)
Command sanitization and validation
No persistent connections or credential storage

📝 Examples

Check disk space on remote server

{
  "tool": "direct_exec",
  "host": "192.168.1.100",
  "username": "admin",
  "password": "secure-password",
  "command": "df -h"
}

Run multiple commands

{
  "tool": "direct_exec",
  "host": "server.example.com",
  "username": "devops",
  "password": "password123",
  "command": "cd /var/log && tail -n 50 syslog"
}

Using SSH key

{
  "tool": "direct_exec",
  "host": "prod-server",
  "username": "deploy",
  "privateKey": "-----BEGIN RSA PRIVATE KEY-----\n...",
  "command": "systemctl status nginx"
}