Portveil

io.github.roybogs由 GitHub 帳號 roybogs 發布v0.4.4更新於 Oct 26, 2026

MCP server for Portveil: let AI assistants see your devices and move them between VPN locations.

已驗證STDIO僅桌面雲端與基礎設施安全與監控

概覽

AI 產生的概覽

Portveil 的 MCP 伺服器，讓 AI 助理檢視帳戶中的裝置，並在不同 VPN 位置之間移動它們。

可以做什麼
列出並檢視裝置、可用位置、帳戶方案與近期活動，包括每台裝置的即時速度與保護狀態。將裝置移到某個國家或城市，或讓它輪換到下一個位置。啟動與停止排程輪換，依設定的分鐘間隔自動移動裝置，可限定在選定的位置之間。重新連線或中斷裝置的通道。新增、重新命名、更新或移除裝置，手機與筆電的通道檔案會存在本機。
適用情境
當你管理多台受 Portveil 保護的裝置或代理機器，想透過助理切換 VPN 出口位置、依排程輪換位置，或查看哪些裝置目前未受保護時，適合使用。
執行需求
透過 npx 在本機執行（需要 Node.js）。需要 Portveil 帳戶，於 PORTVEIL_ACCOUNT_ID 填入帳戶 ID，並於 PORTVEIL_TOKEN 填入具 read 或 control 權限的 API 權杖。PORTVEIL_API 可覆寫 API 基礎位址。裝置需執行 Portveil 應用程式或代理並開啟遠端控制，才能被移動。
安裝前請注意
PORTVEIL_TOKEN 中的權杖可存取你的帳戶；請使用限定權限的權杖而非帳戶金鑰，必要時在儀表板撤銷。control 權限的工具會移動、重新連線、中斷、新增與移除裝置，其中中斷與移除被標示為破壞性操作。排程輪換會持續切換位置，直到停止。伺服器只會向 Portveil API 送出請求。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Portveil，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Portveil MCP server

Let an AI assistant see the devices on your Portveil account and move them between VPN locations.

"Move my scraper box to Finland." "Rotate every agent to a new location." "Which of my devices aren't protected right now?" "Rotate the scraper between the US and Finland every 15 minutes."

Moves are verified: a tool only reports success after the device has switched and the exit server in the new location confirms it sees that device.

Tools

ToolWhat it doesNeeds
list_devicesEvery device: protected or not, where it exits, live speed (↓/↑ Mbps), remote control on/offread
list_locationsThe locations you can move toread
get_deviceOne device's current state, including live speed and any rotationread
get_accountPlan and devices usedread
list_activityRecent moves, reconnects and changes, and which token made themread
move_deviceMove a device to a country or city ("Finland", "US", "Helsinki")control
rotate_deviceMove a device once to the next locationcontrol
start_rotationMove a device automatically every N minutes (5–10080), optionally among chosen locations. Portveil runs the schedule, so the assistant can closecontrol
stop_rotationTurn scheduled rotation offcontrol
reconnect_deviceRe-establish a device's tunnelcontrol
disconnect_deviceTurn a device's VPN off (flagged destructive: a hint that tells well-behaved assistants to check with you first)control
add_deviceAdd a device. Phones and laptops (WireGuard app): creates it and saves its tunnel files locally, key never shown in chat. Linux servers and agent machines: gives the exact commands to run on that machine, which makes its own key and registers itselfadmin (phones/laptops)
update_deviceRename a device and/or turn its remote control on or offadmin
remove_deviceRemove a device for good (flagged destructive)admin

Tool names changed in 0.3.0 to one verb_noun pattern: device_status → get_device, account_info → get_account, recent_activity → list_activity, set_rotation → start_rotation.

Devices can be named loosely ("scraper" finds "Scraper box"); an ambiguous name returns the choices instead of guessing.

Setup

No account yet? Start free with just an email, no card.

  1. In the Portveil dashboard, create an API token. Choose control scope to let the assistant move devices, or read to let it only look. Don't give it your account key.
  2. Note your account ID (acct_…).
  3. Add the server to your assistant:

Claude Code

bash
claude mcp add portveil -e PORTVEIL_ACCOUNT_ID=acct_… -e PORTVEIL_TOKEN=clt_… -- npx -y portveil-mcp

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other clients:

json
{  "mcpServers": {    "portveil": {      "command": "npx",      "args": ["-y", "portveil-mcp"],      "env": { "PORTVEIL_ACCOUNT_ID": "acct_…", "PORTVEIL_TOKEN": "clt_…" }    }  }}

Hermes Agent: Hermes only installs npm packages older than 14 days, so install into its own folder and run it with node:

bash
cd ~ && npm install --prefix ~/.hermes/mcp-servers/portveil [email protected]echo 'PORTVEIL_TOKEN=clt_…' >> ~/.hermes/.envhermes mcp add portveil --command node \  --env PORTVEIL_ACCOUNT_ID=acct_… 'PORTVEIL_TOKEN=${PORTVEIL_TOKEN}' \  --args ~/.hermes/mcp-servers/portveil/node_modules/portveil-mcp/dist/index.js

For Hermes to use it well (when to act, what to confirm first, how to add devices), also install the Portveil skill from ClawHub:

bash
hermes skills install roybogs/portveil

(Source: skills/portveil/SKILL.md.)

Devices must be running the Portveil app or the Portveil agent with remote control on. Devices using the plain WireGuard app are shown but can't be moved.

Security

  • Use a scoped API token. Every action it takes is recorded in your account's activity log with the token that made it, and you can revoke it in the dashboard at any time.
  • The server talks only to https://api.portveil.com (override with PORTVEIL_API). It stores nothing.

Development

bash
npm installnpm test        # builds, then runs the tests against a fake Portveil API

來源：README.md，提交 34328e5

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：伺服器未能啟動。

版本歷史

7
  1. v0.4.4最新Oct 26, 2026
  2. v0.4.3Sep 27, 2026
  3. v0.4.2Sep 27, 2026
  4. v0.4.1Sep 26, 2026
  5. v0.3.0Sep 26, 2026
  6. v0.2.0Sep 25, 2026
  7. v0.1.1Sep 25, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分