English Français العربية

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

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • HOSTKEY_API_KEY إلزامي سري 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)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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» — модель выберет нужные инструменты.

الأسئلة الشائعة

ما هو io.github.hostkey-cloud-ru/mcp-server-ru؟

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

كيف أثبّت io.github.hostkey-cloud-ru/mcp-server-ru؟

يعمل كخادم بعيد. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.hostkey-cloud-ru/mcp-server-ru إلى مفتاح API؟

نعم. يتطلب HOSTKEY_API_KEY, Authorization، وتضبطها في إعداداته.

هل io.github.hostkey-cloud-ru/mcp-server-ru مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.hostkey-cloud-ru/mcp-server-ru؟

ينشره hostkey-cloud-ru. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.