Skip to content
MCP server

VPS Ops

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
5 days ago

About VPS Ops

VPS Ops is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add vps-ops-mcp --env VPS_SSH_KEY_PATH='<VPS_SSH_KEY_PATH>' --env VPS_SSH_KEY_PASSPHRASE='<VPS_SSH_KEY_PASSPHRASE>' -- npx -y @koller-nexus/vps-ops-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "vps-ops-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "vps-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "<VPS_SSH_KEY_PATH>",
        "VPS_SSH_KEY_PASSPHRASE": "<VPS_SSH_KEY_PASSPHRASE>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • VPS_SSH_KEY_PATHAbsolute path to a readable SSH private keyRequired
  • VPS_HOSTSSH hostname of the single target VPS
  • VPS_USERSSH username
  • VPS_PORTSSH port
  • VPS_COMPOSE_DIRAbsolute Compose directory on the remote host
  • VPS_COMMAND_TIMEOUT_MSRemote command timeout in milliseconds
  • VPS_LOG_MAX_BYTESStdout/stderr byte cap for remote commands
  • VPS_ALLOW_MUTATIONSSet false to reject every mutation tool
  • VPS_SSH_KEY_PASSPHRASEOptional key passphrase; prefer ssh-agent instead

Pricing

Open source

VPS Ops FAQ

Is VPS Ops free?

Yes. VPS Ops is open source, so you can use and self-host it for free.

How do I add VPS Ops to Claude Code?

Run this command in your terminal: claude mcp add vps-ops-mcp --env VPS_SSH_KEY_PATH='<VPS_SSH_KEY_PATH>' --env VPS_SSH_KEY_PASSPHRASE='<VPS_SSH_KEY_PASSPHRASE>' -- npx -y @koller-nexus/vps-ops-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers