vpsnet-mcp 1.0.1 → 1.0.3

package/README.md

@@ -1,23 +1,39 @@
 # vpsnet-mcp
 
-[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for managing [VPSNet](https://www.vpsnet.com) virtual private servers. Gives AI assistants full control over your VPS infrastructure — start/stop servers, change plans, manage DNS, deploy SSH keys, order new servers, and more.
+[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for managing [VPSnet.com](https://www.vpsnet.com) virtual private servers. Gives AI assistants full control over your VPS infrastructure — order servers, manage plans, deploy SSH keys, and directly access your servers via SSH for software installation and configuration.
 
 ## Features
 
-- **49 tools** covering the entire VPSNet API
+- **49 tools** covering the entire VPSnet.com API
 - Account & profile management
 - VPS lifecycle (start, stop, restart, reinstall OS)
 - Plan changes (free upgrades/downgrades)
 - DNS (rDNS/PTR records)
-- SSH key & API key management
+- SSH key management — deploy keys and gain direct server access
+- API key management
 - Backups, billing, invoices
 - Ordering new VPS instances
 - System status & pricing
 
+## SSH access workflow
+
+This MCP server manages your VPS infrastructure through the VPSnet.com API, including SSH key provisioning. Once an SSH key is deployed to a VPS, the AI assistant can connect directly using its environment's terminal (e.g. Claude Code's Bash tool, Cline's terminal).
+
+**Typical flow:**
+
+1. AI reads the local machine's public key (`~/.ssh/id_rsa.pub`)
+2. Uploads it to VPSnet.com via `create_ssh_key`
+3. Deploys it to a VPS via `deploy_ssh_key` (or passes it when ordering with `order_service`)
+4. Connects directly: `ssh root@<vps_ip>`
+
+Most AI coding environments (Claude Code, Cline, Cursor, Codex) have built-in terminal access, so the AI can SSH into your VPS immediately after deploying a key — no extra tools needed.
+
+For environments without native SSH access, consider pairing this with a dedicated SSH MCP server for direct server connectivity.
+
 ## Requirements
 
 - Node.js 18 or newer
-- A [VPSNet](https://www.vpsnet.com) account with an API key
+- A [VPSnet.com](https://www.vpsnet.com) account with an API key
 
 ## Getting started
 
@@ -171,7 +187,7 @@ Follow the [Windsurf MCP documentation](https://docs.windsurf.com/windsurf/mcp).
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `VPSNET_API_KEY` | Yes | Your VPSNet API key |
+| `VPSNET_API_KEY` | Yes | Your VPSnet.com API key |
 | `VPSNET_API_URL` | No | API base URL (defaults to `https://api.vpsnet.com`) |
 
 ## Tools
@@ -274,7 +290,7 @@ Follow the [Windsurf MCP documentation](https://docs.windsurf.com/windsurf/mcp).
 | Tool | Description |
 |------|-------------|
 | `get_pricing` | Get public pricing |
-| `get_system_status` | Get VPSNet system status |
+| `get_system_status` | Get VPSnet.com system status |
 | `get_faq` | Get frequently asked questions |
 
 ## Getting an API key

package/build/index.js

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { apiRequest, formatJson } from "./api.js";
 const server = new McpServer({ name: "vpsnet", version: "1.0.0" }, {
     instructions: [
-        "This MCP server controls VPS (Virtual Private Server) services on VPSNet.",
+        "This MCP server controls VPS (Virtual Private Server) services on VPSnet.com.",
         "It manages VPS servers ONLY — not VDS or Dedicated Servers.",
         "",
         "## Ordering a new VPS",
@@ -18,16 +18,27 @@ const server = new McpServer({ name: "vpsnet", version: "1.0.0" }, {
         "After placing an order, wait 10-30 seconds before attempting SSH — the VPS needs time to boot and start SSH daemon.",
         "",
         "## SSH key workflow (IMPORTANT for deploying software to VPS)",
-        "When ordering or accessing a VPS, PREFER using sshKey over rootPassword — unless on Windows without an SSH client.",
-        "To access a VPS via SSH, you MUST use YOUR OWN local machine's SSH key:",
-        "1. Read the local machine's public key from ~/.ssh/id_rsa.pub or ~/.ssh/id_ed25519.pub",
-        "2. Upload it via create_ssh_key(name, public_key) — name it descriptively e.g. 'claude-code-local'",
-        "3. Deploy it to the VPS via deploy_ssh_key(orderNo, ssh_key_id) OR pass sshKey when ordering",
-        "4. Then SSH directly: ssh root@<vps_ip>",
-        "NEVER use someone else's SSH key — always read from the local machine where you are running.",
-        "Only fall back to rootPassword if the local machine has no SSH key and no SSH client (e.g. Windows without OpenSSH).",
-        "Note: order_service uses 'sshKey' (camelCase) but deploy_ssh_key uses 'ssh_key' (snake_case) — different field names!",
-        "To deploy software inside a VPS: first deploy an SSH key to the VPS, then access it directly via SSH. If no SSH client is available (e.g. Windows without OpenSSH), use rootPassword instead and connect via the platform's console or other remote access.",
+        "",
+        "### When the user asks you to deploy, install, or configure something INSIDE a VPS:",
+        "You MUST deploy YOUR OWN SSH key first, then connect directly via SSH.",
+        "After deploying your key, you can INSTANTLY access the VPS — no extra tools needed.",
+        "Most AI environments (Claude Code, Cline, Cursor, Codex) have a built-in terminal/bash tool.",
+        "Use that terminal to run: ssh -o StrictHostKeyChecking=no root@<vps_ip>",
+        "",
+        "### Step-by-step SSH key flow:",
+        "1. Read YOUR local machine's public key from ~/.ssh/id_rsa.pub or ~/.ssh/id_ed25519.pub",
+        "2. Upload it via create_ssh_key(name, public_key) — name it descriptively e.g. 'claude-code-key'",
+        "3. Deploy it to the VPS via deploy_ssh_key(orderNo, ssh_key_id) OR pass sshKey when ordering a new VPS",
+        "4. SSH directly using your environment's terminal: ssh -o StrictHostKeyChecking=no root@<vps_ip>",
+        "5. Now you can run any commands inside the VPS (apt install, configure services, deploy apps, etc.)",
+        "",
+        "### Important SSH notes:",
+        "- ALWAYS prefer sshKey over rootPassword — it's more secure and enables direct access.",
+        "- NEVER use someone else's SSH key — always read from the local machine where you are running.",
+        "- Use -o StrictHostKeyChecking=no when connecting to newly created VPS to avoid host key prompts.",
+        "- order_service uses 'sshKey' (camelCase) but deploy_ssh_key uses 'ssh_key' (snake_case) — different field names!",
+        "- Only fall back to rootPassword if the local machine has no SSH key (e.g. Windows without OpenSSH).",
+        "- If your environment has no terminal/bash access at all, consider using a dedicated SSH MCP server for connectivity.",
         "",
         "## Plan changes",
         "Plan changes are FREE — remaining time is recalculated (upgrade = shorter expiry, downgrade = longer expiry).",
@@ -644,7 +655,7 @@ server.registerTool("get_pricing", {
     return { content: [{ type: "text", text: formatJson(data) }] };
 });
 server.registerTool("get_system_status", {
-    description: "Get VPSNet system status",
+    description: "Get VPSnet.com system status",
     inputSchema: {},
 }, async () => {
     const { data } = await apiRequest("GET", "/public/status");
@@ -661,7 +672,7 @@ server.registerTool("get_faq", {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("VPSNet MCP server running");
+    console.error("VPSnet MCP server running");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "vpsnet-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
-  "description": "MCP server for managing VPSNet virtual private servers",
+  "description": "MCP server for managing VPSnet.com virtual private servers",
   "bin": {
     "vpsnet-mcp": "./build/index.js"
   },
@@ -11,7 +11,9 @@
     "dev": "tsc --watch",
     "prepublishOnly": "npm run build"
   },
-  "files": ["build"],
+  "files": [
+    "build"
+  ],
   "repository": "github:bacarrdy/vpsnet-mcp",
   "homepage": "https://github.com/bacarrdy/vpsnet-mcp",
   "author": "bacarrdy",