Back to Browse

Ru MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP-сервер Hostkey .ru (InvAPI): серверы, питание, заказ, DNS, S3, биллинг

About

MCP-сервер Hostkey .ru (InvAPI): серверы, питание, заказ, DNS, S3, биллинг

Security Report

6.2
Moderate6.2Moderate Risk

This MCP server for Hostkey InvAPI provides comprehensive infrastructure management with proper authentication and confirmation mechanisms for destructive operations. The code is well-structured with secret masking and appropriate permission scoping. However, there are moderate concerns around password parameter validation, broad destructive operation permissions, and potential for accidental data loss through the order/reinstall workflows. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

7 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

InvAPI API key for the .ru portal (invapi.hostkey.ru); per-server keys supportedRequired

Environment variable: HOSTKEY_API_KEY

Session token TTL in seconds (default 3600)Optional

Environment variable: HOSTKEY_TOKEN_TTL

Set to 1 to allow destructive operations (OS reinstall, PXE cycle, service cancellation)Optional

Environment variable: HOSTKEY_ALLOW_DESTRUCTIVE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-hostkey-cloud-ru-mcp-server-ru": {
      "env": {
        "HOSTKEY_API_KEY": "your-hostkey-api-key-here",
        "HOSTKEY_TOKEN_TTL": "your-hostkey-token-ttl-here",
        "HOSTKEY_ALLOW_DESTRUCTIVE": "your-hostkey-allow-destructive-here"
      },
      "args": [
        "-y",
        "hostkey-mcp-server-ru"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Hostkey MCP Server (RU)

MCP-сервер для Hostkey (портал .ru, InvAPI invapi.hostkey.ru). Клиент запускает сервер локально по stdio — из Cursor, VS Code и других MCP-клиентов. Удалённый endpoint: https://mcp.hostkey.ru/mcp (для облачных агентов).

Endpointhttps://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

Install in Cursor

Нажми кнопку, подставь свой InvAPI-ключ вместо YOUR_API_KEY, подтверди.

Или вручную в .cursor/mcp.json:

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

Remote (облачные агенты)

Без локального Node/npx. URL сервиса + InvAPI-ключ:

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

VS Code

.vscode/mcp.json:

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

Опционально: HOSTKEY_TOKEN_TTL, HOSTKEY_HTTP_TIMEOUT, HOSTKEY_ALLOW_DESTRUCTIVE (см. .env.example).

Из исходников (Node.js ≥ 20): npm install && npm run build.

3. Подтверждение опасных операций

Все write-вызовы требуют confirm=true. Без него сервер ничего не меняет.

Дополнительно:

  • заказ сервера по умолчанию в dry_run — реальный заказ только после явного согласия;
  • переустановка ОС, PXE и отмена услуг — только при HOSTKEY_ALLOW_DESTRUCTIVE=1;
  • пароли и токены в ответах маскируются.

Долгие операции (деплой, переустановка) возвращают callback-ключ — статус через 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
PXEcreate_reinstall_task → … → clear_pxe_config
Сеть / DNSпорты, PTR, зоны и записи
Снапшоты, ISO, S3ВМ-снапшоты, образы, бакеты
Remote Handsтикеты дежурной смене (request_rh_*, rhr_*)
Биллингсчета, платежи, контакты
Прочееcheck_task, call_api_raw

Промпты

ПромптЗачем
order_server_promptзаказ сервера по шагам
reinstall_server_promptпереустановка ОС
troubleshoot_server_promptдиагностика

Или просто напишите: «покажи мои серверы» / «закажи VPS в NL» — модель выберет нужные инструменты.

Reviews

No reviews yet

Be the first to review this server!