English Français العربية

io.github.hostkey-cloud-ru/mcp-server-ru

Official registry Search and web

MCP server for Hostkey .ru (InvAPI): servers, power, order, DNS, S3, billing

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-server-ru 'https://mcp.hostkey.ru/mcp' --header 'Authorization: <Bearer <InvAPI API key> for the .ru portal (invapi.hostkey.ru)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-server-ru": {
            "type": "http",
            "url": "https://mcp.hostkey.ru/mcp",
            "headers": {
                "Authorization": "<Bearer <InvAPI API key> for the .ru portal (invapi.hostkey.ru)>"
            }
        }
    }
}
NPM package hostkey-mcp-server-ru
Claude Code 
claude mcp add mcp-server-ru -e 'HOSTKEY_API_KEY=<your hostkey_api_key>' -e 'HOSTKEY_TOKEN_TTL=<HOSTKEY_TOKEN_TTL>' -e 'HOSTKEY_ALLOW_DESTRUCTIVE=<HOSTKEY_ALLOW_DESTRUCTIVE>' -- npx -y hostkey-mcp-server-ru@1.0.8
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-server-ru": {
            "command": "npx",
            "args": [
                "-y",
                "hostkey-mcp-server-ru@1.0.8"
            ],
            "env": {
                "HOSTKEY_API_KEY": "<your hostkey_api_key>",
                "HOSTKEY_TOKEN_TTL": "<HOSTKEY_TOKEN_TTL>",
                "HOSTKEY_ALLOW_DESTRUCTIVE": "<HOSTKEY_ALLOW_DESTRUCTIVE>"
            }
        }
    }
}

Environment variables

  • HOSTKEY_API_KEY required secret InvAPI API key for the .ru portal (invapi.hostkey.ru); per-server keys supported
  • HOSTKEY_TOKEN_TTL Session token TTL in seconds (default 3600)
  • HOSTKEY_ALLOW_DESTRUCTIVE Set to 1 to allow destructive operations (OS reinstall, PXE cycle, service cancellation)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Hostkey MCP Server (RU)
  2. 1. Получите API-ключ
  3. 2. Установка
  4. 3. Подтверждение опасных операций
  5. 4. Инструменты
  6. Промпты

Hostkey MCP Server (RU)

MCP-сервер для Hostkey (портал .ru, InvAPI invapi.hostkey.ru). Клиент подключается по URL или локально по stdio (Cursor, VS Code и др.). Hosted: https://mcp.hostkey.ru/mcp (для .com — https://mcp.hostkey.com/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 (hosted 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. Подтверждение опасных операций

Все 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» — модель выберет нужные инструменты.

Frequently asked questions

What is io.github.hostkey-cloud-ru/mcp-server-ru?

MCP server for Hostkey .ru (InvAPI): servers, power, order, DNS, S3, billing

How do I install io.github.hostkey-cloud-ru/mcp-server-ru?

It runs as a remote server. In Claude Code: claude mcp add --transport http mcp-server-ru 'https://mcp.hostkey.ru/mcp' --header 'Authorization: <Bearer <InvAPI API key> for the .ru portal (invapi.hostkey.ru)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.hostkey-cloud-ru/mcp-server-ru need an API key?

Yes. It expects HOSTKEY_API_KEY, Authorization, which you set in its configuration.

Is io.github.hostkey-cloud-ru/mcp-server-ru open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.hostkey-cloud-ru/mcp-server-ru?

It is published by hostkey-cloud-ru. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.