websupport-mcp

MCP-сервер (TypeScript, ESM, stdio), оборачивающий REST API v1 + v2 Websupport — DNS, FTP, хостинг, базы данных, почтовые ящики, VPS и счета — предоставляемый как инструменты MCP с подписанной HMAC-SHA1 аутентификацией.

Статус: в разработке. Все 50 инструментов реализованы, и сервер работает. Осталось проверить на аккаунте с реальными ресурсами, упаковать и выпустить. См. IMPLEMENTATION_PLAN.md для прогресса.

Уровни риска

Инструменты регистрируются в трёх уровнях, и уровень ограничивает регистрацию — развёртывание только для чтения вообще не видит инструмент записи в tools/list, поэтому оно не тратит контекст клиента и не предоставляет никаких возможностей.

Инструмент является destructive, если он уничтожает состояние, которое нельзя дёшево воссоздать — не просто потому, что он пишет. Мягкая перезагрузка VPS — это write; жёсткое выключение питания — destructive, потому что оно может повредить незавершённые записи. Создание снимка — write; восстановление — destructive, потому что оно отбрасывает всё, что было после.

Две опции включения независимы: WEBSUPPORT_ALLOW_DESTRUCTIVE=1 сам по себе не разблокирует инструменты записи, и наоборот.

Аргумент confirm: true, а не MCP-элиситация, является границей безопасности. Согласование протокола может остановиться на версии значительно ниже той, что поддерживает элиситацию — SDK этого сервера в настоящее время ограничен версией 2025-11-25 — и шлюз, который исчезает при работе со старым клиентом, не является шлюзом.

Related MCP server: cpanel-mcp

Установка

Ещё не опубликовано. Чтобы запустить из локальной копии:

npm install
npm run build

Затем укажите на него MCP-клиент:

Требуется Node >= 22.

{
  "mcpServers": {
    "websupport": {
      "command": "node",
      "args": ["/absolute/path/to/websupport-mcp/dist/index.js"],
      "env": {
        "WEBSUPPORT_API_KEY": "…",
        "WEBSUPPORT_API_SECRET": "…"
      }
    }
  }
}

Учётные данные

Создайте пару доступа к API Standard в WebAdmin (Security → API keys). Пара только для DynDNS аутентифицируется на /nic/update и ни на чём другом.

Скопируйте .env.example для локальной разработки. .env игнорируется git.

Рынки

Websupport — региональный бренд team.blue/Loopia, поэтому хост API выбирает рынок. Одно и то же приложение обслуживает каждый хост — GET /v2/docs/openapi.json байт-в-байт одинаков на всех — так что переключение рынков — это конфигурация, а не изменение кода.

Неопознанный хост выводит предупреждение в stderr и всё равно используется, поэтому недавно добавленный рынок работает без ожидания релиза.

Документация

Область применения

Создание заказов и конечные точки оплаты счетов/заказов намеренно вне области применения и проверяются тестами на отсутствие. CRUD записей DNS v1 и CRUD FTP-аккаунтов v1 устарели на стороне провайдера и не предоставляются — инструменты v2 покрывают оба.

Разработка

npm test              # offline suite
npm run test:network  # live, unauthenticated probes (market hosts + OpenAPI drift)
npm run typecheck
npm run lint
npm run build

Сетевые наборы тестов намеренно разделены: сбой Websupport не должен приводить к падению сборки.

Инструментарий

Node >= 22 для запуска или сборки. Node 20 достиг конца жизни 2026-04-30 и не поддерживается. CI покрывает две действующие линии LTS, 22 и 24, и собирает и проводит дымовые тесты пакета на каждой.

Для сборки также нужен npm >= 11: npm 10 не может разрешить дерево зависимостей бандлера и падает с бесполезной ошибкой Cannot read properties of null (reading 'edgesOut'). Если вы столкнулись с этим, обновите npm, а не отлаживайте репозиторий.

Безопасность

Учётные данные, которые хранит этот сервер, дают полный контроль над аккаунтом Websupport — не существует пары API только для чтения. SECURITY.md описывает, как они обрабатываются, какие инструменты возвращают чувствительные данные и как сообщить об уязвимости конфиденциально.

Вклад

См. CONTRIBUTING.md. Обратите внимание на две границы, обеспечиваемые тестами, а не ревью: никаких конечных точек заказов или платежей, и каждый разрушительный инструмент должен объявлять confirm: true.

Лицензия

MIT — см. LICENSE.