Repository navigation
Releases
Releases · AVert/cloud-mcp
v0.2.0 — переезд sweb-mcp на discovery-стек
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
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/ipaddLocal/removeLocal (два документа на один путь)
и/vh/mailgetMailQuota (дважды) — 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).