mcp-server-ru

Hostkey MCP Server（RU）

适用于 Hostkey 的 MCP 服务（.ru 门户，InvAPI invapi.hostkey.ru）。 客户端可通过 URL 或在本地通过 stdio 连接（Cursor、VS Code 等）。 托管版：https://mcp.hostkey.ru/mcp（.com 版为 https://mcp.hostkey.com/mcp）。

Endpoint	https://invapi.hostkey.ru（硬编码在代码中）
授权	HOSTKEY_API_KEY
工具	132 个类型化工具 + call_api_raw

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

对于 .com 门户，请使用独立软件包 hostkey-mcp-server。

1. 获取 API 密钥

InvAPI → API 密钥管理 → 创建密钥。

建议为 MCP 单独创建密钥。仅限单台服务器的密钥会将访问权限限制在该服务器。 写入 DNS 需要 pdns/edit 权限。

2. 安装

Cursor（托管 URL — 推荐）

在 .cursor/mcp.json 中配置（一个或两个门户）：

{
  "mcpServers": {
    "hostkey-com": {
      "url": "https://mcp.hostkey.com/mcp",
      "headers": {
        "Authorization": "Bearer key-from-invapi.hostkey.com"
      }
    },
    "hostkey-ru": {
      "url": "https://mcp.hostkey.ru/mcp",
      "headers": {
        "Authorization": "Bearer key-from-invapi.hostkey.ru"
      }
    }
  }
}

替换为你的 InvAPI 密钥。无需本地安装 Node/npx。

Cursor（本地 npx / stdio）

{
  "mcpServers": {
    "hostkey-com": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.com"
      }
    },
    "hostkey-ru": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server-ru"],
      "env": {
        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.ru"
      }
    }
  }
}

VS Code

.vscode/mcp.json — 使用相同配置方式（url + headers 或 command / args / env）。

stdio 的可选配置：HOSTKEY_TOKEN_TTL、HOSTKEY_HTTP_TIMEOUT、HOSTKEY_ALLOW_DESTRUCTIVE （参见 .env.example）。

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

3. 确认危险操作

所有写入调用都需要 confirm=true。未设置时，服务不会进行任何更改。

此外：

• 服务器默认以 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”——模型会选择所需工具。