NestDaddy

VPS Ops

io.github.koller-nexus/vps-ops-mcp · v0.1.0

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

Connect Runs on your machine

Terminal
claude mcp add vps-ops-mcp -e VPS_SSH_KEY_PATH=<VPS_SSH_KEY_PATH> -e VPS_HOST=<VPS_HOST> -e VPS_USER=<VPS_USER> -e VPS_PORT=<VPS_PORT> -e VPS_COMPOSE_DIR=<VPS_COMPOSE_DIR> -e VPS_COMMAND_TIMEOUT_MS=<VPS_COMMAND_TIMEOUT_MS> -e VPS_LOG_MAX_BYTES=<VPS_LOG_MAX_BYTES> -e VPS_ALLOW_MUTATIONS=<VPS_ALLOW_MUTATIONS> -e VPS_SSH_KEY_PASSPHRASE=<VPS_SSH_KEY_PASSPHRASE> -- npx -y @koller-nexus/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/[email protected]"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_HOST": "<VPS_HOST>",
        "VPS_USER": "<VPS_USER>",
        "VPS_PORT": "<VPS_PORT>",
        "VPS_COMPOSE_DIR": "<VPS_COMPOSE_DIR>",
        "VPS_COMMAND_TIMEOUT_MS": "<VPS_COMMAND_TIMEOUT_MS>",
        "VPS_LOG_MAX_BYTES": "<VPS_LOG_MAX_BYTES>",
        "VPS_ALLOW_MUTATIONS": "<VPS_ALLOW_MUTATIONS>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/[email protected]"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_HOST": "<VPS_HOST>",
        "VPS_USER": "<VPS_USER>",
        "VPS_PORT": "<VPS_PORT>",
        "VPS_COMPOSE_DIR": "<VPS_COMPOSE_DIR>",
        "VPS_COMMAND_TIMEOUT_MS": "<VPS_COMMAND_TIMEOUT_MS>",
        "VPS_LOG_MAX_BYTES": "<VPS_LOG_MAX_BYTES>",
        "VPS_ALLOW_MUTATIONS": "<VPS_ALLOW_MUTATIONS>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "vps-ops-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/[email protected]"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_HOST": "<VPS_HOST>",
        "VPS_USER": "<VPS_USER>",
        "VPS_PORT": "<VPS_PORT>",
        "VPS_COMPOSE_DIR": "<VPS_COMPOSE_DIR>",
        "VPS_COMMAND_TIMEOUT_MS": "<VPS_COMMAND_TIMEOUT_MS>",
        "VPS_LOG_MAX_BYTES": "<VPS_LOG_MAX_BYTES>",
        "VPS_ALLOW_MUTATIONS": "<VPS_ALLOW_MUTATIONS>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package@koller-nexus/[email protected] (NPM, stdio)
First published22 Sep 2026
Last updated22 Sep 2026
Registry nameio.github.koller-nexus/vps-ops-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.