hostkey-cloud

Hostkey MCP 服务

适用于 Hostkey 的 MCP 服务（.com 门户，InvAPI invapi.hostkey.com）。 通过 stdio 在本地运行，适用于 Cursor、VS Code 和其他 MCP 客户端。 托管远程服务：https://mcp.hostkey.com/mcp（云端 Agent）。

端点	https://invapi.hostkey.com（硬编码）
身份验证	HOSTKEY_API_KEY
工具	132 个类型化工具 + call_api_raw

让模型能够访问你的 Hostkey 账户：服务器、目录和订购、电源、操作系统重装、网络、DNS、快照、IPMI/控制台、ISO、S3、Remote Hands、账单和 API 密钥。

1. 获取 API 密钥

InvAPI → API keys → create a key。

建议为 MCP 使用专用密钥。每台服务器的密钥会将访问权限限制在一台服务器上。 写入 DNS 需要 pdns/edit 权限。

2. 安装

Cursor

点击按钮，将 YOUR_API_KEY 替换为你的 InvAPI 密钥，然后确认。

或者手动添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "hostkey-mcp-server": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "your-api-key"
      }
    }
  }
}

远程（云端 Agent）

无需本地 Node/npx。将客户端指向托管端点并发送你的 InvAPI 密钥：

{
  "mcpServers": {
    "hostkey": {
      "url": "https://mcp.hostkey.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "hostkey-mcp-server": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "your-api-key"
      }
    }
  }
}

可选：HOSTKEY_TOKEN_TTL、HOSTKEY_HTTP_TIMEOUT、HOSTKEY_ALLOW_DESTRUCTIVE （参见 .env.example）。

从源代码安装（Node.js ≥ 22.18）：npm install && npm run build。

3. 确认危险操作

每次写入调用都需要 confirm=true。否则不会有任何更改。

此外：

• order_server 默认为 dry_run，只有明确同意后才会实际下单；
• 操作系统重装、PXE 和取消服务需要设置 HOSTKEY_ALLOW_DESTRUCTIVE=1；
• 响应中的密码和令牌会被屏蔽。

长时间运行的任务（部署、重装）会返回回调密钥，可使用 check_task 轮询。

4. 工具

工具分组（完整列表请通过 tools/list 获取）：

分组	示例
服务器	get_servers、get_server、get_power_status
目录	list_presets、list_os、list_traffic_plans
电源和订购	power_on、power_off、order_server、reinstall_server
PXE	create_reinstall_task → … → clear_pxe_config
网络 / DNS	端口、PTR、区域和记录
快照、ISO、S3	VM 快照、镜像、存储桶
Remote Hands	值班工单（request_rh_*、rhr_*）
账单	发票、付款、联系人
其他	check_task、call_api_raw

提示词

提示词	用途
order_server_prompt	引导式服务器订购
reinstall_server_prompt	操作系统重装
troubleshoot_server_prompt	诊断

也可以直接询问：“列出我的服务器” / “在 NL 订购一台 VPS”。

文档

• 项目状态
• 操作日志
• QA：托管 URL