ssh-vps-mcp

# ssh-vps-mcp **MCP server for remote VPS management via SSH key authentication — built for Claude Code.** Manage files and run commands on your remote VPS directly from Claude Code using the Model Context Protocol (MCP). Only SSH key authentication is supported — passwords are explicitly rejected. --- ## Features - **SSH key-only auth** — RSA, Ed25519, ECDSA, DSS. No passwords. - **File operations** — read, write, append, delete, rename, stat - **Directory operations** — list, create, delete (recursive) - **Shell execution** — run any command with stdout/stderr/exit code capture - **Connection check** — `vps_ping` tool with server info - **Secure** — checks key file permissions (must be `600`), no SSH agent fallback, no `~/.ssh` key scanning --- ## Installation ```bash pip install ssh-vps-mcp ``` Or install from source: ```bash git clone https://github.com/aldirrss/ssh-vps-mcp cd ssh-vps-mcp pip install . ``` Verify installation: ```bash ssh-vps-mcp --version ``` --- ## Usage with Claude Code ### 1. Configure in Claude Code Add to your Claude Code MCP config. The config file is at: - **Global**: `~/.claude.json` - **Project-level**: `.claude/settings.json` (in your project root) ```json { "mcpServers": { "vps": { "command": "ssh-vps-mcp", "args": [ "--host", "YOUR_VPS_IP_OR_HOSTNAME", "--user", "root", "--private-key-path", "~/.ssh/id_rsa" ] } } } ``` ### 2. Or add via Claude Code CLI ```bash claude mcp add vps -- ssh-vps-mcp \ --host YOUR_VPS_IP \ --user root \ --private-key-path ~/.ssh/id_rsa ``` ### 3. Start Claude Code ```bash claude ``` You'll see the VPS MCP connect on startup. Then ask Claude to manage your server: ``` > Can you check what's in /var/log/nginx/ on the VPS? > Deploy this nginx config to /etc/nginx/sites-available/myapp > Run: systemctl restart nginx ``` --- ## Authentication Options ### Option A: Private key file (recommended) ```json { "mcpServers": { …