S
SkillNav

Biznet Gio云管理

Biznet Gio Cloud Management

by anak10thn

Manage Biznet Gio cloud infrastructure (servers, VMs, storage, IPs) via CLI and MCP server

4.5kDevOps未扫描2026年4月6日

安装

npx @biznetgio/cli@latest

文档

Biznet Gio Cloud Management - Agent Skill Guide

Skill Metadata

FieldValue
NameBiznet Gio Cloud Management
DescriptionManage Biznet Gio cloud infrastructure (servers, VMs, storage, IPs) via CLI and MCP
Homepagehttps://github.com/BiznetGIO/biznetgio-cli
npm (CLI)@biznetgio/cli
npm (MCP)@biznetgio/mcp
API Docshttps://api.portal.biznetgio.com/v1/openapi.json
LicenseMIT
Primary CredentialBIZNETGIO_API_KEY

Required Environment Variables

VariableRequiredDescription
BIZNETGIO_API_KEYYesAPI token from Biznet Gio Portal. Sent as x-token header on every request. Do not hardcode — always use env var.
BIZNETGIO_BASE_URLNoOverride API base URL. Defaults to https://api.portal.biznetgio.com/v1. Useful for staging/dev environments.

Required Binaries

BinaryVersionRequiredDescription
node>= 18YesNode.js runtime for the CLI and MCP server.
npx(bundled with node)YesFetches and runs @biznetgio/cli from the npm registry without global installation.

Runtime Note

This skill executes the npm package @biznetgio/cli via npx, which downloads and runs code from the npm registry. The package is published under the @biznetgio npm scope by Biznet Gio. Source code is available at github.com/BiznetGIO/biznetgio-cli. If you require stronger guarantees, you can:

  • Pre-install with npm install -g @biznetgio/cli and verify the package before use
  • Use the pre-built standalone binaries from the GitHub releases
  • Pin to a specific version: npx @biznetgio/cli@1.0.0 instead of @latest
  • Run in a sandboxed environment

You are an agent that can manage Biznet Gio cloud infrastructure using the CLI tool @biznetgio/cli and/or MCP server @biznetgio/mcp.

Important Instructions

  1. Always use npx to run the CLI. No installation required.
  2. Read-only commands run without confirmation. Commands like list, detail, products, product-os, product-ip, state, info, usage, regions, openvpn, vm-details, url, credential list, bucket list, object list, keypair list, snapshot list, disk list, and other read-only queries can be executed directly without asking for user approval.
  3. Confirm before create, update, or delete actions. Before running any command that creates, modifies, or deletes a resource, show the user the full command with all values and ask for confirmation. The user may want to revise parameter values before execution.
  4. For destructive actions (delete, rebuild, state changes), double confirm. Clearly warn the user about the impact and ask explicitly: "Are you sure?"
  5. For create operations, list all parameters and let the user review and adjust before executing. Show product options, OS choices, and pricing when available.

How to Run

bash
# With API key inline
BIZNETGIO_API_KEY=<YOUR_KEY> npx @biznetgio/cli@latest <service> <action> [arguments] [options]

# Or export the key first
export BIZNETGIO_API_KEY=<YOUR_KEY>
npx @biznetgio/cli@latest <service> <action> [arguments] [options]

# Or pass API key as flag
npx @biznetgio/cli@latest <service> <action> --api-key <YOUR_KEY> [arguments] [options]
  • API Key: environment variable BIZNETGIO_API_KEY (sent as x-token header), or --api-key flag
  • Base URL: https://api.portal.biznetgio.com/v1 (override with BIZNETGIO_BASE_URL env)
  • Output format: default table, use --output json for JSON output

Available Services

ServiceCLI CommandMCP Tool PrefixDescription
NEO Metalmetalmetal_*Bare metal servers
Elastic Storageelastic-storageelastic_storage_*Storage for bare metal
Additional IPadditional-ipadditional_ip_*Additional IPs for bare metal
NEO Liteneoliteneolite_*Virtual machines (lightweight)
NEO Lite Proneolite-proneolite_pro_*Virtual machines (pro-tier)
Object Storageobject-storageobject_storage_*S3-compatible object storage

General Pattern

bash
npx @biznetgio/cli@latest <service> <action> [arguments] [options]
npx @biznetgio/cli@latest <service> <subgroup> <action> [arguments] [options]

Global options: --api-key <key>, --output table|json

Output Behavior

  • Default: table — List data is displayed as formatted tables. Nested objects (billing, specs, options) are automatically flattened. Billing is summarized as price/mo.
  • --output json — Raw JSON from the API .data field.
  • Primitive responses (e.g. delete, update-label) return plain text like success or true.
  • Empty lists show No data found.

Valid Enum Values

  • Billing cycle (--cycle): m (monthly), q (quarterly), s (semi-annual), a (annual), b (biennial), t (triennial), p4, p5
  • Metal states: on, off, reset
  • VM states (neolite/neolite-pro): stop, suspend, resume, shutdown, start, reset
  • Object ACL: private, public-read, public-read-write, authenticated-read, log-delivery-write
  • Console password: must match ^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)[a-zA-Z\d]{8,}$ (min 8 chars, uppercase + lowercase + digit, alphanumeric only — no special characters)
  • Label: max 16 characters

Workflow & Best Practices

Before Creating Resources

  1. List products first to get valid product_id values:

    bash
    npx @biznetgio/cli@latest metal products
npx @biznetgio/cli@latest neolite products
npx @biznetgio/cli@latest object-storage products

  2. Check available OS for a product:

    bash
    npx @biznetgio/cli@latest metal product-os <product_id>
npx @biznetgio/cli@latest neolite product-os <product_id>

  3. Check available keypairs (or create one first):

    bash
    npx @biznetgio/cli@latest neolite keypair list
npx @biznetgio/cli@latest neolite keypair create --name "my-key"

  4. Check IP availability (neolite):

    bash
    npx @biznetgio/cli@latest neolite product-ip <product_id>

Creating Resources

bash
# Create a bare metal server
npx @biznetgio/cli@latest metal create \
  --product-id <id> --cycle m --keypair-id <id> \
  --label "my-server" --public-ip 1 --select-os "ubuntu-22.04"

# Create a NEO Lite instance
npx @biznetgio/cli@latest neolite create \
  --product-id <id> --cycle m --select-os "Ubuntu-20.04" \
  --keypair-id <id> --ssh-and-console-user myuser \
  --console-password TestPass123

# Create a NEO Lite Pro instance
npx @biznetgio/cli@latest neolite-pro create \
  --product-id <id> --cycle m --select-os "Ubuntu-20.04" \
  --keypair-id <id> --ssh-and-console-user myuser \
  --console-password TestPass123

# Create object storage (label max 16 chars)
npx @biznetgio/cli@latest object-storage create \
  --product-id <id> --cycle m --label "my-storage"

# Create elastic storage (requires metal_account_id)
npx @biznetgio/cli@latest elastic-storage create \
  --product-id <id> --cycle m --storage-name "data-vol" \
  --metal-account-id <id>

# Create additional IP
npx @biznetgio/cli@latest additional-ip create --product-id <id> --cycle m

Deleting Resources

bash
npx @biznetgio/cli@latest metal delete <account_id>
npx @biznetgio/cli@latest neolite delete <account_id>
npx @biznetgio/cli@latest neolite-pro delete <account_id>
npx @biznetgio/cli@latest elastic-storage delete <account_id>
npx @biznetgio/cli@latest additional-ip delete <account_id>
npx @biznetgio/cli@latest object-storage delete <account_id>
npx @biznetgio/cli@latest object-storage bucket delete <account_id> <bucket_name>
npx @biznetgio/cli@latest object-storage object delete <account_id> <bucket_name> <path>
npx @biznetgio/cli@latest neolite snapshot delete <account_id>
npx @biznetgio/cli@latest neolite disk delete <account_id>
npx @biznetgio/cli@latest <service> keypair delete <keypair_id>

Managing Server State

bash
# NEO Metal: on / off / reset
npx @biznetgio/cli@latest metal set-state <account_id> on
npx @biznetgio/cli@latest metal set-state <account_id> off

# NEO Lite / Pro: start / stop / shutdown / suspend / resume / reset
npx @biznetgio/cli@latest neolite set-state <account_id> start
npx @biznetgio/cli@latest neolite set-state <account_id> stop
npx @biznetgio/cli@latest neolite-pro set-state <account_id> shutdown

Object Storage Operations

bash
# Credential management
npx @biznetgio/cli@latest object-storage credential list <account_id>
npx @biznetgio/cli@latest object-storage credential create <account_id>
npx @biznetgio/cli@latest object-storage credential update <account_id> <access_key> --active
npx @biznetgio/cli@latest object-storage credential delete <account_id> <access_key>

# Bucket operations
npx @biznetgio/cli@latest object-storage bucket list <account_id>
npx @biznetgio/cli@latest object-storage bucket create <account_id> --name my-bucket
npx @biznetgio/cli@latest object-storage bucket info <account_id> <bucket_name>
npx @biznetgio/cli@latest object-storage bucket usage <account_id> <bucket_name>
npx @biznetgio/cli@latest object-storage bucket set-acl <account_id> <bucket_name> --acl public-read
npx @biznetgio/cli@latest object-storage bucket delete <account_id> <bucket_name>

# Object operations
npx @biznetgio/cli@latest object-storage object list <account_id> <bucket_name>
npx @biznetgio/cli@latest object-storage object list <account_id> <bucket_name> <directory>
npx @biznetgio/cli@latest object-storage object info <account_id> <bucket_name> <path>
npx @biznetgio/cli@latest object-storage object download <account_id> <bucket_name> <object_name>
npx @biznetgio/cli@latest object-storage object url <account_id> <bucket_name> <object_name> --expiry 3600
npx @biznetgio/cli@latest object-storage object copy <account_id> <bucket_name> <to_bucket> <object_name>
npx @biznetgio/cli@latest object-storage object move <account_id> <bucket_name> <to_bucket> <object_name>
npx @biznetgio/cli@latest object-storage object mkdir <account_id> <bucket_name> <directory>
npx @biznetgio/cli@latest object-storage object set-acl <account_id> <bucket_name> <path> --acl private
npx @biznetgio/cli@latest object-storage object delete <account_id> <bucket_name> <path>

Snapshot & Disk Management (NEO Lite / Pro)

bash
# Snapshots
npx @biznetgio/cli@latest neolite snapshot create <account_id> --cycle m
npx @biznetgio/cli@latest neolite snapshot list
npx @biznetgio/cli@latest neolite snapshot detail <account_id>
npx @biznetgio/cli@latest neolite snapshot restore <account_id>
npx @biznetgio/cli@latest neolite snapshot create-instance <snapshot_account_id> \
  --product-id <id> --cycle m --keypair-id <id> --name "from-snap" \
  --ssh-and-console-user myuser --console-password TestPass123
npx @biznetgio/cli@latest neolite snapshot delete <account_id>
npx @biznetgio/cli@latest neolite snapshot products
npx @biznetgio/cli@latest neolite snapshot product <product_id>

# Additional disks
npx @biznetgio/cli@latest neolite disk create \
  --product-id <id> --cycle m --neolite-account-id <id>
npx @biznetgio/cli@latest neolite disk list
npx @biznetgio/cli@latest neolite disk detail <account_id>
npx @biznetgio/cli@latest neolite disk upgrade <account_id> --additional-size 20
npx @biznetgio/cli@latest neolite disk delete <account_id>
npx @biznetgio/cli@latest neolite disk products
npx @biznetgio/cli@latest neolite disk product <product_id>

Keypair Management

bash
# Available for: metal, neolite, neolite-pro
npx @biznetgio/cli@latest <service> keypair list
npx @biznetgio/cli@latest <service> keypair create --name "my-key"
npx @biznetgio/cli@latest <service> keypair import --name "my-key" --public-key "ssh-rsa AAAA..."
npx @biznetgio/cli@latest <service> keypair delete <keypair_id>

Upgrade & Scaling

bash
# Upgrade neolite/neolite-pro storage
npx @biznetgio/cli@latest neolite upgrade-storage <account_id> --disk-size 50
npx @biznetgio/cli@latest neolite-pro upgrade-storage <account_id> --disk-size 100

# Change package (upgrade plan) — check options first
npx @biznetgio/cli@latest neolite change-package-options <account_id>
npx @biznetgio/cli@latest neolite change-package <account_id> --new-product-id <id>

# Upgrade elastic storage
npx @biznetgio/cli@latest elastic-storage upgrade <account_id> --size 100

# Change elastic storage package
npx @biznetgio/cli@latest elastic-storage change-package <account_id> --new-product-id <id>

# Upgrade object storage quota
npx @biznetgio/cli@latest object-storage upgrade-quota <account_id> --add-quota 50

# Migrate neolite to pro — check options first
npx @biznetgio/cli@latest neolite migrate-to-pro-products <account_id>
npx @biznetgio/cli@latest neolite migrate-to-pro <account_id> --neolitepro-product-id <id>

Rebuild / Reinstall OS

bash
# Check available OS for rebuild
npx @biznetgio/cli@latest metal rebuild-os <account_id>

# Rebuild
npx @biznetgio/cli@latest metal rebuild <account_id> --os "ubuntu-22.04"
npx @biznetgio/cli@latest neolite rebuild <account_id> --select-os "Ubuntu-20.04"
npx @biznetgio/cli@latest neolite-pro rebuild <account_id> --select-os "Ubuntu-20.04"

Update & Rename

bash
# Update metal label (max 16 chars)
npx @biznetgio/cli@latest metal update-label <account_id> --label "new-label"

# Rename neolite/neolite-pro VM
npx @biznetgio/cli@latest neolite rename <account_id> --name "new-name"
npx @biznetgio/cli@latest neolite-pro rename <account_id> --name "new-name"

# Change keypair
npx @biznetgio/cli@latest neolite change-keypair <account_id> --keypair-id <id>
npx @biznetgio/cli@latest neolite-pro change-keypair <account_id> --keypair-id <id>

Additional IP Assignment

bash
# List and create IPs
npx @biznetgio/cli@latest additional-ip list
npx @biznetgio/cli@latest additional-ip regions
npx @biznetgio/cli@latest additional-ip create --product-id <id> --cycle m

# Assign IP to bare metal
npx @biznetgio/cli@latest additional-ip assign <ip_account_id> --metal-account-id <metal_id>
npx @biznetgio/cli@latest additional-ip assigns <ip_account_id>
npx @biznetgio/cli@latest additional-ip assignments <metal_account_id>
npx @biznetgio/cli@latest additional-ip assign-detail <ip_account_id> <metal_account_id>

# Unassign
npx @biznetgio/cli@latest additional-ip unassign <ip_account_id> <metal_account_id>

Detail & Info Commands

bash
# Account details
npx @biznetgio/cli@latest metal detail <account_id>
npx @biznetgio/cli@latest neolite detail <account_id>
npx @biznetgio/cli@latest neolite-pro detail <account_id>
npx @biznetgio/cli@latest elastic-storage detail <account_id>
npx @biznetgio/cli@latest additional-ip detail <account_id>
npx @biznetgio/cli@latest object-storage detail <account_id>

# VM details
npx @biznetgio/cli@latest neolite vm-details <account_id>
npx @biznetgio/cli@latest neolite-pro vm-details <account_id>

# Server state
npx @biznetgio/cli@latest metal state <account_id>

# OpenVPN config
npx @biznetgio/cli@latest metal openvpn

Destructive Actions - Use With Caution!

The following commands are destructive and cannot be undone. ALWAYS confirm with the user before running:

  • All delete commands (server, VM, storage, IP, bucket, object, snapshot, disk, keypair)
  • rebuild commands (reinstalls OS, wipes data)
  • set-state off/shutdown/reset (may cause downtime)

MCP Server Tools Reference

When using the MCP server, all endpoints are exposed as tools with naming convention <service>_<action>. Examples:

CLI CommandMCP Tool
metal listmetal_list
metal detail 123metal_detail {account_id: 123}
metal set-state 123 onmetal_set_state {account_id: 123, state: "on"}
neolite create ...neolite_create {product_id, cycle, ...}
object-storage bucket list 123object_storage_bucket_list {account_id: 123}
neolite snapshot listneolite_snapshot_list {}
neolite disk create ...neolite_disk_create {product_id, cycle, ...}
object-storage delete 123object_storage_delete {account_id: 123}

Total: 131 tools available in the MCP server.

MCP server configuration for Claude Desktop / Claude Code:

json
{
  "mcpServers": {
    "biznetgio": {
      "command": "npx",
      "args": ["-y", "@biznetgio/mcp@latest"],
      "env": {
        "BIZNETGIO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Troubleshooting

ErrorSolution
API key not setSet export BIZNETGIO_API_KEY=xxx or use --api-key flag
API Error 401API key is invalid or expired
API Error 404Resource not found, check the account_id
API Error 422Validation error — check password regex, label max 16 chars, required fields
API Error 500Server error — retry or check if the resource exists
No data found.The list is empty, no resources of this type exist yet

相关 Skills

环境密钥管理

by alirezarezvani

Universal
热门

统一梳理dev/staging/prod的.env和密钥流程，自动生成.env.example、校验必填变量、扫描Git历史泄漏，并联动Vault、AWS SSM、1Password、Doppler完成轮换。

✎ 统一管理环境变量、密钥与配置，减少泄露和部署混乱，安全治理与团队协作一起做好，DevOps 场景很省心。

DevOps
未扫描15.8k

可观测性设计

by alirezarezvani

Universal
热门

面向生产系统规划可落地的可观测性体系，串起指标、日志、链路追踪与 SLI/SLO、错误预算、告警和仪表盘设计，适合搭建监控平台与优化故障响应。

✎ 把监控、日志、链路追踪串起来，帮助团队从设计阶段构建可观测性，排障更快、系统演进更稳。

DevOps
未扫描15.8k

更新日志

by alirezarezvani

Universal
热门

基于 Conventional Commits 自动解析提交记录、判断语义化版本升级并生成规范 changelog，适合在 CI、发版前检查提交格式并批量输出可审计发布说明。

✎ 自动生成和管理更新日志与发布说明，帮团队把版本变更说清楚；聚焦版本化与流程自动化，省时又更规范。

DevOps
未扫描15.8k

相关 MCP 服务

kubefwd

编辑精选

by txn2

热门

kubefwd 是让 AI 帮你批量转发 Kubernetes 服务到本地的开发神器。

✎ 微服务开发者最头疼的本地调试问题，它一键搞定——自动分配 IP 避免端口冲突，还能用自然语言查询状态。但依赖 AI 工作流，纯命令行爱好者可能觉得不够直接。

DevOps
4.1k

Cloudflare

编辑精选

by Cloudflare

热门

Cloudflare MCP Server 是让你用自然语言管理 Workers、KV 和 R2 等云资源的工具。

✎ 这个工具解决了开发者频繁切换控制台和文档的痛点，特别适合那些在 Cloudflare 上部署无服务器应用、需要快速调试或管理配置的团队。不过，由于它依赖多个子服务器，初次设置可能有点繁琐，建议先从 Workers Bindings 这类核心功能入手。

DevOps
3.8k

Terraform

编辑精选

by hashicorp

热门

Terraform MCP Server 是让 AI 助手直接操作 Terraform Registry 和 HCP Terraform 的桥梁。

✎ 如果你经常在 Terraform 里翻文档找模块配置，这个服务器能省不少时间——直接问 Claude 就能生成准确的代码片段。最适合管理多云基础设施的团队，但注意它目前只适合本地使用，别在生产环境里暴露 HTTP 端点。

DevOps
1.4k

评论