Vpsnet MCP

vpsnet mcp

模型上下文协议 用于管理的（MCP）服务器 VPSnet.com 虚拟专用服务器。让AI助手完全控制您的VPS基础设施——订购服务器、管理计划、部署SSH密钥，并通过SSH直接访问您的服务器进行软件安装和配置。

特性

• 49工具 覆盖整个VPSnet.com API
• 账户和个人资料管理
• VPS生命周期（启动、停止、重启、重新安装操作系统）
• 计划更改（免费升级/降级）
• DNS（rDNS/PTR记录）
• SSH密钥管理——部署密钥并获得直接服务器访问权限
• API密钥管理
• 备份、账单、发票
• 订购新的VPS实例
• 系统状态和定价

先决条件

安装前，请确保：

1. Node.js 18或更新版本

- 检查： node --version - Linux/macOS： 或您的包裹管理器 - 窗户： winget install OpenJS.NodeJS.LTS 或从以下网址下载 - 安装Node.js后， 重新启动终端/编辑器

1. 对于Claude Code（CLI或VS Code扩展）用户：

- 全局安装的Claude Code CLI： npm install -g @anthropic-ai/claude-code - 检查： claude --version

1. 活跃的 VPSnet.com 账户 使用API密钥（请参见 获取API密钥)

SSH访问工作流

此MCP服务器通过VPSnet.com API管理您的VPS基础设施，包括SSH密钥供应。一旦SSH密钥部署到VPS，AI助手就可以使用其环境的终端（例如Claude Code的Bash工具、Cline的终端）直接连接。

典型流程：

1. AI读取本地机器的公钥(~/.ssh/id_rsa.pub)
2. 通过以下方式上传到VPSnet.com create_ssh_key
3. 通过以下方式将其部署到VPS deploy_ssh_key （或在订购时传递给 order_service)
4. 直接连接： ssh root@

大多数AI编码环境（Claude Code、Cline、Cursor、Codex）都有内置的终端访问，因此AI可以在部署密钥后立即SSH到您的VPS中——不需要额外的工具。

对于没有本机SSH访问的环境，请将其与 mcp服务器ssh 用于通过MCP工具直接连接服务器。

组合配置：

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      }
    },
    "ssh": {
      "command": "npx",
      "args": ["-y", "mcp-server-ssh"]
    }
  }
}

入门

选择您的环境：

• 克劳德代码（CLI） --基于终端的AI编码
• 克劳德代码VS代码 --VS代码扩展
• 克劳德桌面版 --桌面应用程序
• --副驾驶代理模式
• 克莱恩 / 光标 / 帆板运动 / Roo 代码 / 法典 --其他客户

标准配置适用于大多数MCP客户端：

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here",
        "VPSNET_API_TIMEOUT_MS": "45000"
      }
    }
  }
}

Claude Code

claude mcp add vpsnet -- npx -y vpsnet-mcp

运行前设置环境变量：

export VPSNET_API_KEY="your_api_key_here"
export VPSNET_API_TIMEOUT_MS="45000"

Claude Code for VS Code Extension

本节适用于 克劳德代码VS代码扩展，而不是GitHub Copilot。如果你在GitHub Copilot上使用VS Code，请参阅 取而代之的是部分。

第一步： 全局安装Claude Code CLI（扩展所需）：

npm install -g @anthropic-ai/claude-code

第二步： 通过CLI添加MCP服务器：

claude mcp add vpsnet -- npx -y vpsnet-mcp

步骤3： 添加您的API密钥。编辑 ~/.claude.json （或 C:\Users\\.claude.json 在Windows上），找到 vpsnet 服务器部分并添加 env 块：

"vpsnet": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "vpsnet-mcp"],
    "env": {
        "VPSNET_API_KEY": "your_api_key_here",
        "VPSNET_API_URL": "https://api.vpsnet.com"
    }
}

步骤4： 完全重新启动VS代码（Ctrl+Shift+P>“重新加载窗口”或关闭并重新打开）。

步骤5： 通过询问克劳德来验证： *“获取我的VPSnet帐户信息”*

Windows用户： 运行时使用PowerShell或CMD（不是Git Bash） claude mcp add 命令。

这 code --add-mcp 命令执行 非 使用Claude Code扩展——这仅适用于VS Code Copilot。

Claude Desktop

跟随 MCP安装指南，使用上面的标准配置。

Cline

打开Cline MCP设置并添加到您的 cline_mcp_settings.json:

{
  "mcpServers": {
    "vpsnet": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      },
      "disabled": false
    }
  }
}

Codex

使用Codex CLI：

codex mcp add vpsnet --env VPSNET_API_KEY=your_api_key_here -- npx -y vpsnet-mcp

或编辑 ~/.codex/config.toml:

[mcp_servers.vpsnet]
command = "npx"
args = ["-y", "vpsnet-mcp"]

[mcp_servers.vpsnet.env]
VPSNET_API_KEY = "your_api_key_here"

如果系统的默认Node.js早于18 （与nvm常见--请检查 node --version)，包装命令，以便nvm加载正确的版本：

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'

注： Codex需要网络访问权限才能通过npx安装软件包。如果你在没有网络的受限沙盒中运行Codex，npx安装将失败。

Cursor

首选 光标设置 > 主控程序 > 添加新的MCP服务器。将命令类型与命令一起使用 npx -y vpsnet-mcp。或手动添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Roo Code

打开Roo Code MCP设置并添加到 roo_mcp_settings.json:

{
  "mcpServers": {
    "vpsnet": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      },
      "disabled": false
    }
  }
}

VS Code with GitHub Copilot

使用VS Code CLI进行安装：

code --add-mcp '{"name":"vpsnet","command":"npx","args":["-y","vpsnet-mcp"],"env":{"VPSNET_API_KEY":"your_api_key_here"}}'

或者使用上面的标准配置手动添加到您的VS Code MCP配置中。

这是为了 GitHub Copilot VS Code中的代理模式。对于 克劳德代码 扩展，请参阅 VS代码扩展的Claude代码 部分。

Windsurf

跟随 Windsurf MCP文件.使用上面的标准配置。

windows用户

• 使用 PowerShell或CMD （不是Git Bash） claude mcp add 命令
• 配置文件位置： C:\Users\\.claude.json
• 安装Node.js： winget install OpenJS.NodeJS.LTS 或从以下网址下载
• 安装Node.js后， 重新启动终端和VS代码
• Claude Code扩展中的环境变量必须位于 env 对象内 .claude.json，不是系统环境变量

环境变量

工具

账户

服务

服务行动

服务设置

操作系统重新安装

计划更改（免费）

续订和计费

订购

备份

SSH密钥

API密钥

历史

公共

获取API密钥

1. 登录地址： vpsnet.com
2. 首选 账户 > API密钥
3. 点击 创建API密钥
4. 给它起个名字，然后复制钥匙

密钥只显示一次，请安全存储。

故障排除

MCP工具未出现在Claude Code VS Code扩展中

1. 安装Claude Code命令行界面： npm install -g @anthropic-ai/claude-code
2. 验证： claude --version 应显示版本号
3. 通过CLI添加服务器： claude mcp add vpsnet -- npx -y vpsnet-mcp
4. 完全重新启动VS代码 （不仅仅是重新加载窗口）
5. 检查 ~/.claude.json 正确配置

claude: command not found

全局安装Claude Code CLI：

npm install -g @anthropic-ai/claude-code

验证你的PATH是否包含npm全局包。在Windows上，安装后重新启动终端。

环境变量不起作用

对于Claude Code扩展，环境变量 必须 加入 env 对象内 .claude.json，不是系统环境变量：

"vpsnet": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "vpsnet-mcp"],
    "env": {
        "VPSNET_API_KEY": "your_actual_key_here"
    }
}

API关键错误

• 验证密钥是否正确（以开头 vpsnet_)
• 密钥在创建时只显示一次——如果丢失，请创建一个新的密钥
• 检查密钥是否未过期（帐户>API密钥）

deploy_ssh_key 成功，但SSH仍然失败

• 所有VPSnet.com服务器都使用 root 作为SSH用户名
• 密钥部署是异步的——部署后等待15-30秒再尝试SSH

fetch is not defined 或意外错误

此服务器需要 Node.js 18+ （使用内置 fetch API如果你的默认 node 较旧（常见于nvm设置），或者：

• 将节点18+设置为默认值： nvm alias default 20
• 或者使用nvm包装器，如 法典 部分

许可证

麻省理工学院