Skip to content

Releases: GPUtw-ai/GPUtw-Skill

Release list

v1.1.0-beta.1 — official MCP server (beta)

v1.1.0-beta.1 — official MCP server (beta) Pre-release
Pre-release

Choose a tag to compare

View all tags
@luke2023 luke2023 released this 15 Sep 17:41
v1.1.0-beta.1
bda5420

第一版官方 MCP 伺服器：把 GPUtw 控制平面包成結構化工具呼叫，助理不用再自己組 curl。Skill 內容本身仍是 v1.0.0 的穩定內容。

安裝

/plugin marketplace add GPUtw-ai/GPUtw-Skill
/plugin install gputw@gputw

安裝時會問 GPUtw API 金鑰（標記 sensitive，存在安全儲存區，不寫進純文字設定）。一次拿到知識 Skill ＋ 18 個工具 ＋ 4 個斜線指令。

只要 MCP：

claude mcp add gputw -s user -e GPUTW_API_KEY=gputw_live_xxx -- node <clone>/mcp/dist/stdio.mjs

⚠️ 兩種安裝方式請只選一種。外掛與 ~/.claude/skills/gputw/ 手動安裝同名，Claude Code 會以外掛為準。

18 個工具

  • 目錄 list-gpus、list-available-nodes、list-templates、get-deploy-options
  • 執行個體 create-instance、stop-instance、delete-instance、restart-instance
  • 即時狀態 get-instance-status、get-instance-resources、get-instance-logs、get-instance-events
  • Vault list-vault、get-vault-stats、upload-to-vault、download-model-to-vault、list-vault-downloads
  • 選用 exec-in-instance（容器內 root shell，需 GPUTW_MCP_ALLOW_EXEC=1 ＋ instances:exec scope，預設不註冊）

設計重點

  • 標註 readOnlyHint / destructiveHint / idempotentHint，客戶端才分得出讀取與刪除
  • 錯誤翻成行動：缺哪個 scope、402 要儲值、409 要重選機器、非信封回應代表請求沒到 API（通常是缺 User-Agent）
  • 欄位投影：目錄一筆原始紀錄約 50 欄，投影後 < 20 欄，不吃掉模型上下文
  • upload-to-vault 實作完整分段續傳：傳輸主機探測、伺服器決定的 chunkSize、receivedParts 續傳、sha256 驗證
  • 金鑰只從環境變數讀，不落地、不記錄；輸出中 gputw_live_… 一律遮蔽

尚未收錄（請用 curl，見 guides/）

連接埠與 exposures、API 金鑰管理、帳務與付款、團隊、通知、預約、工單。完整端點見 references/endpoints.md。

驗證

55 個離線單元測試（不需網路與金鑰）、型別檢查、CI 會重建 bundle 並確認與 src/ 一致，並跑一次 MCP initialize 握手。本次發布已在實機驗證：外掛安裝成功、MCP 顯示 Connected、userConfig 金鑰確實傳進行程、對 api.gputw.ai 的實際呼叫回傳真實目錄與範本資料。

已知事項

  • npm 套件 @gputw/mcp-server 尚未發佈，因此 npx -y @gputw/mcp-server 目前不可用；外掛走 clone 內的 mcp/dist/stdio.mjs（已提交的單檔 bundle），不需 npm。
  • 僅本機 stdio；沒有 hosted 端點與 OAuth。

文件：guides/12-mcp.md ｜ mcp/README.md

Loading