vpsnet-mcp 1.0.7 → 1.0.9

package/README.md

@@ -184,7 +184,7 @@ Open Cline MCP settings and add to your `cline_mcp_settings.json`:
 Use the Codex CLI:
 
 ```bash
-codex mcp add vpsnet npx "vpsnet-mcp"
+codex mcp add vpsnet --env VPSNET_API_KEY=your_api_key_here -- npx -y vpsnet-mcp
 ```
 
 Or edit `~/.codex/config.toml`:
@@ -192,10 +192,19 @@ Or edit `~/.codex/config.toml`:
 ```toml
 [mcp_servers.vpsnet]
 command = "npx"
-args = ["vpsnet-mcp"]
+args = ["-y", "vpsnet-mcp"]
+
+[mcp_servers.vpsnet.env]
+VPSNET_API_KEY = "your_api_key_here"
+```
+
+**If your system's default Node.js is older than 18** (common with nvm — check with `node --version`), wrap the command so nvm loads the right version:
+
+```bash
+codex mcp add vpsnet --env VPSNET_API_KEY=your_api_key_here -- bash -lc 'source ~/.nvm/nvm.sh >/dev/null 2>&1 && nvm use --silent 20 && npx -y vpsnet-mcp'
 ```
 
-Set `VPSNET_API_KEY` in your shell environment before running Codex.
+> **Note:** Codex requires network access to install packages via npx. If you run Codex in a restricted sandbox without network, npx installs will fail.
 
 </details>
 
@@ -433,6 +442,18 @@ For Claude Code extension, environment variables **must** be in the `env` object
 - Keys are shown only once at creation — if lost, create a new one
 - Check that the key hasn't expired (Account > API Keys)
 
+### `deploy_ssh_key` succeeded but SSH still fails
+
+- All VPSnet.com servers use `root` as the SSH username
+- Key deployment is async — wait 15-30 seconds after deploying before attempting SSH
+
+### `fetch is not defined` or unexpected errors
+
+This server requires **Node.js 18+** (uses the built-in `fetch` API). If your default `node` is older (common with nvm setups), either:
+
+- Set Node 18+ as default: `nvm alias default 20`
+- Or use the nvm wrapper shown in the [Codex](#codex) section
+
 ## License
 
 [MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vpsnet-mcp",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "description": "MCP server for managing VPSnet.com virtual private servers",
   "bin": {