VPS Ops MCP Server

io.github.koller-nexus/vps-ops-mcp

Repository Registry

What is the VPS Ops MCP server?

Stdio MCP server that inspects and (with confirmation) mutates one VPS over SSH.

How to install VPS Ops

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

VPS_SSH_KEY_PATH
required
secret
Absolute path to a readable SSH private key
VPS_HOST
SSH hostname of the single target VPS
VPS_USER
SSH username
VPS_PORT
SSH port
VPS_COMPOSE_DIR
Absolute Compose directory on the remote host
VPS_COMMAND_TIMEOUT_MS
Remote command timeout in milliseconds
VPS_LOG_MAX_BYTES
Stdout/stderr byte cap for remote commands
VPS_ALLOW_MUTATIONS
Set false to reject every mutation tool
VPS_SSH_KEY_PASSPHRASE
secret
Optional key passphrase; prefer ssh-agent instead

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "bunx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<YOUR_VPS_SSH_KEY_PATH>",
        "VPS_HOST": "<YOUR_VPS_HOST>",
        "VPS_USER": "<YOUR_VPS_USER>",
        "VPS_PORT": "<YOUR_VPS_PORT>",
        "VPS_COMPOSE_DIR": "<YOUR_VPS_COMPOSE_DIR>",
        "VPS_COMMAND_TIMEOUT_MS": "<YOUR_VPS_COMMAND_TIMEOUT_MS>",
        "VPS_LOG_MAX_BYTES": "<YOUR_VPS_LOG_MAX_BYTES>",
        "VPS_ALLOW_MUTATIONS": "<YOUR_VPS_ALLOW_MUTATIONS>",
        "VPS_SSH_KEY_PASSPHRASE": "<YOUR_VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}