VPN连接工具

一个基于NordVPN CLI的本地stdio MCP服务器,提供VPN状态查询、连接、断开、服务器列表等功能。

  • by AlejandroAkbal
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 AlejandroAkbal/nordvpn-macos-mcp

使用说明

nordvpn mcp

本地stdio MCP服务器,在用户提供的NordVPN CLI项目签出周围暴露了一个薄工具层。

预期的CLI后端是您的分支:

  • https://github.com/AlejandroAkbal/nordvpn-macos-cli

必需的启动参数

此MCP需要NordVPN CLI项目根作为其第一个启动参数,或通过 NORDVPN_PROJECT_ROOT 环境变量。

例子:

node dist/index.js /Users/lume/Projects/nordvpn-operator

工具

  • vpn_status
  • vpn_list_countries
  • vpn_list_servers
  • vpn_connect
  • vpn_disconnect
  • vpn_rotate
  • vpn_setup

发展

pnpm install
pnpm build
pnpm test
node dist/index.js /Users/lume/Projects/nordvpn-operator

OpenCode应该通过以下方式启动此服务器 ~/.config/opencode/opencode.json 使用stdio。

验证语义

vpn_status 解析现在可以识别CLI后端发出的验证结果:

  • verified
  • country_mismatch
  • country_unconfirmed
  • unavailable (用于没有国家范围的显式服务器连接)

vpn_connect 和 vpn_rotate 后续验证(verifyAfterConnect / verifyAfterRotate)在回到简单的观察国家比较之前,优先考虑这些解析的状态。

PATH行为

启动时,服务器确保Homebrew二进制路径存在于 PATH:

  • /opt/homebrew/bin
  • /opt/homebrew/sbin

这允许MCP启动的子流程发现 openvpn 当它通过Homebrew安装时。