Skip to content

Releases

v0.2.0 — переезд sweb-mcp на discovery-стек

Choose a tag to compare

@AVert AVert released this 19 Nov 04:18

cloud-mcp v0.2.0 — sweb-mcp переезжает сюда

Breaking change: 276 per-op тулов заменены пятью discovery-тулами. Имена операций сохранены,
вызовы идут через cloud_call. Репозиторий sweb-mcp переименован в cloud-mcp — история,
звёзды и issues остались с нами.

Провайдеры

Провайдер Операций Транспорт
SpaceWeb (sweb.ru) 276 JSON-RPC 2.0, Bearer + getToken, re-login на -32603
Timeweb Cloud 515 REST, Bearer
Selectel 746 (31 продукт) REST, IAM account/project, static, X-Project-Id
Tilda 10 REST, ключи в query

Что изменилось

  • 5 тулов вместо сотен: cloud_search, cloud_describe, cloud_call, cloud_providers,
    cloud_catalog; провайдер — аргумент вызова.
  • Safety-классы (read/write/destructive/paid) считаются при сборке снапшотов; write требует
    confirm=true, destructive/paid — CLOUD_READONLY=0 + CLOUD_ALLOW_DESTRUCTIVE=1.
  • Снапшоты из публичной документации провайдеров, scripts/sync_specs.py --check ловит дрейф.
  • Поиск: RU/EN запросы, алиасы, camelCase-идентификаторы; бенчмарк 57 запросов, top-1 ≥ 90 %.

Миграция со sweb-mcp 0.1

Было Стало
sweb_list_methods cloud_search(provider="sweb", query=…)
sweb_describe(path, method) cloud_describe(provider="sweb", tool="<объект>_<метод>")
sweb_call(path, method, params) cloud_call(provider="sweb", tool="<объект>_<метод>", …)
sweb_accounts / sweb_use_account account="имя" в cloud_call
SWEB_READONLY / SWEB_ALLOW_DESTRUCTIVE CLOUD_READONLY / CLOUD_ALLOW_DESTRUCTIVE (старые имена читаются)
SWEB_ACCOUNTS_FILE / SWEB_ACCOUNT / SWEB_TOKEN продолжают работать как фолбэк
ghcr.io/avert/sweb-mcp ghcr.io/avert/cloud-mcp

Точка входа sweb-mcp сохранена как алиас cloud-mcp.

Качество

  • 105 тестов (JSON-RPC транспорт, re-login, снапшоты, поиск, безопасность), ruff чист,
    CI на Python 3.11–3.13, сборка sdist/wheel.

sweb-mcp v0.1.0

Choose a tag to compare

@AVert AVert released this 14 Nov 02:24

sweb-mcp v0.1.0

Первый публичный релиз MCP-сервера для клиентского API SpaceWeb (sweb.ru).

Возможности

  • 276 уникальных методов (29 объектов) API как MCP tools <объект>_<метод>
    (vps_index, domains_dns_editTxt, vh_mail_createMbox, …).
  • Meta-tools: sweb_list_methods, sweb_describe, sweb_call, sweb_accounts,
    sweb_use_account.
  • Классификация безопасности: read / write / destructive / paid.
    Read выполняется свободно; write требует confirm=true; destructive/paid —
    ещё SWEB_READONLY=0 + SWEB_ALLOW_DESTRUCTIVE=1.
  • Мультиаккаунт: единственный источник учёток — JSON-файл из SWEB_ACCOUNTS_FILE;
    аккаунт по умолчанию — SWEB_ACCOUNT; переключение на лету — sweb_use_account
    или параметр account в вызове.
  • Сессия истекает с кодом -32603 (из транспорта SDK) — автоперелогин.

Спеки

  • specs/*.json — OpenRPC-снапшот документации apidoc.sweb.ru, полученный
    scripts/sync_specs.py; логика извлечения портирована из MIT-проекта
    sanchpet/sweb-go-sdk.
  • В апстриме есть дубли: /vps/ip addLocal/removeLocal (два документа на один путь)
    и /vh/mail getMailQuota (дважды) — 279 записей схлопываются в 276 уникальных.

Rate limiting

  • Клиент: семафор SWEB_MAX_CONCURRENCY (4) + пауза SWEB_MIN_INTERVAL (0.2 с)
    между стартами запросов.
  • Повторы с экспоненциальной паузой (SWEB_MAX_RETRIES=3, SWEB_BACKOFF_BASE=0.5,
    потолок 30 с, Retry-After учитывается): HTTP 429 — для любых методов (запрос
    отклонён до обработки); 502/503/504 и сетевые ошибки — только для read (исход
    write/destructive/paid неизвестен, повтор мог бы задвоить заказ/удаление).
  • Официальные лимиты SpaceWeb нигде не документированы — значения подобраны
    консервативно и настраиваются env.

Тесты

31 тест: спеки, классификатор безопасности, клиент на respx (логин, перелогин,
повторы, троттлинг) и сервер через in-memory MCP-сессию.

Установка

uvx --from git+https://github.com/avert/sweb-mcp sweb-mcp
# или
git clone https://github.com/avert/sweb-mcp && cd sweb-mcp
uv sync && cp .env.example .env && uv run --env-file .env sweb-mcp

Проект неофициальный и не аффилирован со SpaceWeb. Лицензия — MIT (см. LICENSE, NOTICE).