我為 QNAP Virtualization Station 打造了一個開源的 MCP(模型上下文協議,Model Context Protocol)伺服器,讓你能透過 AI 助理(如 Claude)管理虛擬機。
功能介紹
35 項工具,讓你用自然語言完整管理虛擬機:
- 虛擬機生命週期 — 啟動、關閉、重設、暫停、恢復
- 虛擬機管理 — 更新 CPU/記憶體、複製、匯出、刪除
- 快照 — 建立、還原、刪除
- 磁碟與 ISO — 調整大小、掛載/卸載
- 監控 — 資源儀表板顯示主機 CPU/RAM 使用率、每台虛擬機摘要與網路狀態
- 安全性 — 所有破壞性操作都需明確確認
運作方式
伺服器會與 Virtualization Station 的 REST API(與網頁介面相同的 API)通訊。支援兩種模式:
- 本地(stdio) — 在你的電腦上執行,透過 HTTPS 連接 NAS
- 遠端(SSE) — 以 Docker 容器方式在 NAS 上執行,AI 客戶端可透過網路使用 Bearer token 驗證連接
安裝方式
# 透過 pip/uvx
uvx mcp-server-qnap-qvs
# 透過 Docker
docker pull ghcr.io/arnstarn/mcp-server-qnap-qvs:latest
# 透過 QPKG(在 App Center 側載)
# 從 GitHub Releases 下載
你也可以新增這個 App Center 軟體庫網址,自動獲取更新:
https://raw.githubusercontent.com/arnstarn/mcp-server-qnap-qvs/main/qpkg/repo.xml
(App Center > 設定 > 軟體庫)
系統需求
- QNAP NAS,x86 CPU(Intel/AMD)
- QTS 5.1.0+ 或 QuTS hero h5.1.0+
- 已安裝 Virtualization Station
- Container Station(用於 Docker/QPKG 部署)
相關連結
- GitHub: GitHub - arnstarn/mcp-server-qnap-qvs: MCP server for QNAP Virtualization Station (QVS) - manage virtual machines, snapshots, disks, and more via the QVS REST API · GitHub
- PyPI: Client Challenge
已於 QuTS hero h5.2.8 與 Virtualization Station 4.1.x 測試通過。MIT 授權,歡迎貢獻。
有任何問題或功能需求,歡迎提出!