sweb-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sweb-mcp show my SpaceWeb sites and which ones are missing SSL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
cloud-mcp
Один MCP-сервер (stdio) сразу для нескольких облачных провайдеров: SpaceWeb (276 методов
JSON-RPC), Timeweb Cloud (515 операций), Selectel (31 продукт, 746 операций), Tilda
Publishing (10). Провайдер — аргумент вызова, а не переменная окружения: переключение без
рестарта и без обхода кэша tools/list у клиента.
Ищете SpaceWeb MCP / sweb mcp — это он же: SpaceWeb живёт здесь как провайдер sweb
(раньше — отдельный репозиторий sweb-mcp, см. «Переход с sweb-mcp 0.1»).
Вместо сотен tool-схем в промпте — discovery-интерфейс из 5 инструментов:
cloud_search(query="перезагрузить сервер") → топ операций с именами/методами/параметрами
cloud_describe(provider="timeweb", tool="servers_reboot") → полная схема
cloud_call(provider="timeweb", tool="servers_reboot", args={"server_id": 1}) → вызов
cloud_providers() → провайдеры, продукты, счётчики, состояние кредов
cloud_catalog(provider="selectel") → grep-файл «читай тут» с правилами и индексом операцийПоиск
Лексический ранкер без эмбеддингов и без индекса: RU→EN алиасы, стемминг (кириллица — 5-символьный
стем, латиница — слово/множественное число), вес 1.0 у набранного слова и 0.5 у алиаса, на токен
берётся лучшее поле (tool 9 / path 4 / продукт 2.5 / summary 1.5), бонус корневой коллекции
ресурса, гейт по HTTP-методу при явном действии («удалить» → DELETE), бонус провайдеру, если его
имя упомянуто в запросе. Бенчмарк — 51 запрос RU/EN против 1271 операции: top-1 ≥ 90%,
top-3 = 100% (tests/test_search.py::BENCHMARK, регрессия ловится тестом).
Related MCP server: whm-mcp-server
Установка
# из git, без клонирования (обе точки входа: cloud-mcp и прежняя sweb-mcp)
uvx --from git+https://github.com/AVert/cloud-mcp cloud-mcp
uvx --from git+https://github.com/AVert/cloud-mcp sweb-mcp # то же самое, старое имя
# разработка
git clone https://github.com/AVert/cloud-mcp && cd cloud-mcp
python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
python scripts/sync_specs.py # обновить снапшоты API из документации провайдеров
# контейнер
docker run -i --rm -e CLOUD_ACCOUNTS_FILE=/accounts.json \
-v "$HOME/.config/cloud-mcp:/cfg:ro" ghcr.io/avert/cloud-mcpУчётные данные
Один файл на все провайдеры — CLOUD_ACCOUNTS_FILE (по умолчанию
~/.config/cloud-mcp/accounts.json, chmod 600, в git не попадает):
{
"timeweb": {"token": "eyJ..."},
"selectel": {"iam_token": "...", "static_token": "...", "login": "svc_user", "password": "...", "account_id": "12345"},
"tilda": {"public_key": "...", "private_key": "..."}
}timeweb —
Authorization: Bearer <token>. Совместимость: читается старыйTIMEWEB_ACCOUNTS_FILE/TIMEWEB_TOKEN, если cloud-файла нет.selectel — три вида доступа, и продукт сам решает, какой ему нужен:
account-scoped IAM-токен (
X-Auth-Token): баланс, тикеты, пользователи и роли, аудит, глобальный роутер, проекты, федерации;project-scoped IAM-токен + заголовок
X-Project-Id: CDN, DNS, приватный DNS, Managed Kubernetes, Managed Databases, бэкапы по расписанию, публичные порты, 1С-облако, object storage, почтовый сервис, сертификаты Let's Encrypt;статический токен (
X-Token): legacy API без IAM (часть биллинга, ipam). Сlogin/passwordсервисного пользователя (+account_id,project_id) оба IAM-токена выпускаются автоматически через Keystone и кэшируются; готовые токены тоже принимаются. Какой именно вид нужен конкретному вызову, снапшот хранит на каждую операцию (securityиз спеки; описание схемы приоритетнее имени — документация Selectel ошибается: secrets-manager зовёт схему account-scoped, а принимает project).
sweb — JSON-RPC 2.0:
Authorization: Bearer <token>, токен берётся черезPOST /notAuthorized/getToken(логин/пароль) и переиспользуется до-32603(тогда автоматический re-login). Пейсинг 5 rps и 4 параллельных запроса по умолчанию.tilda —
publickey/privatekeyв query каждого запроса.
Файл читается лениво: дописать токен можно в уже запущенный сервер (правки кода — только рестарт).
Первичная настройка Selectel
Рабочий вариант — сервисный пользователь (токены без срока 24 ч): скрипт сам создаёт его, выдаёт роли, выпускает пароль и проверяет оба токена живым read-запросом.
python scripts/selectel_service_user.py # reader на аккаунт + на проект
python scripts/selectel_service_user.py --write # member (полный доступ), не reader
python scripts/selectel_service_user.py --s3 # плюс access key/secret для S3
python scripts/selectel_service_user.py --list # кем уже владеет аккаунт
python scripts/selectel_service_user.py --delete svc-cloud-mcp --yesПо умолчанию — минимальные права (reader): просмотр всех проектов, квот и биллинга. Пароль
генерируется локально, не печатается и пишется в файл учёток (0600); панельные токены (24 ч)
после успешной проверки убираются, чтобы клиент не ходил ими до истечения. Действия с
пользователями требуют админского токена — --token <панельный IAM-токен>, у reader его нет
(ответ будет 403 с подсказкой).
Разово проверить готовые токены или дописать их вручную:
python scripts/selectel_auth.py --login svc-cloud --account-id 123456 # пароль спросим
python scripts/selectel_auth.py --login svc-cloud --account-id 123456 --project-id 7f1c…
python scripts/selectel_auth.py --iam-token <панельный токен> # быстрая проверка, 24 ч
python scripts/selectel_auth.py --project-token <токен> --project-id 7f1c…
python scripts/selectel_auth.py --static-token <API-ключ> # legacy X-Token
python scripts/selectel_auth.py --check # что реально работаетОба скрипта ничего не печатают из секретов, проверяют каждый токен живым read-запросом и мержат
запись selectel в файл учёток (остальные провайдеры не затираются), права 0600.
Регионы Selectel
Базовые URL каждого продукта берутся из таблицы «URL для обращения к API» документации Selectel
и хранятся в снапшоте по-регионально (base_urls: ru-2, ru-3, ru-8, kz-1, uz-1…). Регион
выбирается переменной SELECTEL_REGION (по умолчанию ru-2); точечный оверрайд —
SELECTEL_BASE_<SLUG> (пример: SELECTEL_BASE_MANAGED_DATABASES=https://ru-3.dbaas.selcloud.ru/v1).
Региональные продукты: 1c-cloud, cloud-public-network, managed-databases, managed-kubernetes,
managed-kubernetes-legacy, object-storage, private-dns, quota-management, scheduled-backups.
Дубли версий в URL разруливаются при сборке снапшота: /v2/clusters в путях спецификации и
…/v2 в URL документации не задваиваются.
Безопасность
Класс операции определяется при сборке снапшота и хранится в нём: read / write /
destructive / paid (src/cloud_mcp/core/safety.py). read — свободно; write — требует
confirm: true; destructive/paid — только при CLOUD_READONLY=0 и
CLOUD_ALLOW_DESTRUCTIVE=1. Удаления Selectel могут отвечать 403 с запросом кода подтверждения —
повторить вызов с hash.
Env
Переменная | По умолчанию | Что делает |
|
| учётки всех провайдеров |
|
| куда |
| все | включить подмножество: |
|
| запретить всё, кроме read |
|
| разрешить destructive/paid |
|
| таймаут HTTP, сек |
| пакетные | свой каталог снапшотов |
|
| регион для региональных продуктов selectel |
| — | точечный оверрайд базового URL продукта |
| — | совместимость со старым timeweb-mcp |
Подключение в OpenCode
"cloud": {
"type": "local",
"command": ["/path/to/cloud-mcp/.venv/bin/cloud-mcp"],
"environment": {
"CLOUD_ACCOUNTS_FILE": "/home/<user>/.config/cloud-mcp/accounts.json"
}
}Снапшоты и их обновление
specs/ — нормализованные снапшоты документации (Timeweb OpenAPI 3.0, Selectel — Swagger 2.0 /
OpenAPI 3.x по продуктам, Tilda — hand-written: официального OpenAPI у Tilda нет). Источник истины
— документация провайдеров; обновление: python scripts/sync_specs.py, проверка дрейфа:
--check. Ошибка классификации операции правится в core/safety.py, а не в снапшоте руками.
Провайдер-специфика
timeweb: списки пагинируются
limit/offset; удаление может требоватьhash(код из Telegram); ошибки приходят как[code] message.selectel: пагинация
per-page/page(илиsize/page); IAM-токен живёт час; у части продуктов только статический токен.tilda: все операции read-only (экспорт сайтов/страниц);
getfullexportвозвращаетexportid, статус —getexport, ссылка —getexportlink.
Tilda: что доступно без тарифа Business
Экспортное API Tilda (publickey/secretkey, Настройки сайта → Экспорт → API) и её родные
«Ключи MCP» открываются только на тарифе Business; сторонние MCP-серверы для Tilda
(theYahia/tilda-mcp и подобные) ходят в то же API, поэтому без Business бесполезны. Провайдер
tilda в этом сервере остаётся в снапшотах (10 read-операций), но по умолчанию выключен:
CLOUD_PROVIDERS=timeweb,selectel.
Опубликованные страницы читаются без всякого API — для бэкапа и инвентаризации есть офлайн-скрипт:
python scripts/tilda_backup.py --site https://example.com --out ~/tilda/example # весь сайт по sitemap
python scripts/tilda_backup.py --site https://example.com --out ~/tilda/example --diff # что изменилось
python scripts/tilda_backup.py --url https://example.com/page.html --out ~/tilda/one # одна страницаПишет <out>/pages/*.html (сырой HTML) и <out>/index.json: title, description, og, число
блоков и их record-type, изображения, внутренние/внешние ссылки, формы, css/js. Ноль токенов на
прогон: модель читает индекс с диска, а не браузерные снапшоты. Правки и настройки (то, чего в
публичных страницах нет) — только через браузерный MCP, по требованию.
SpaceWeb (sweb.ru)
276 уникальных методов 29 объектов превращаются в операции с прежними именами
<объект>_<метод> (vps_reboot, domains_dns_editTxt, vh_mail_createMbox, …) — тем же
именам, что были в per-op сервере, только доступны они через cloud_call(provider="sweb", tool="vps_reboot", ...).
Учётные записи: entry sweb в общем файле учёток — {"login": "…", "password": "…"}.
Несколько аккаунтов — блоком accounts и default_account, переключение на один вызов —
аргументом account="имя":
{"sweb": {"login": "main-login", "password": "…",
"accounts": {"work": {"login": "…", "password": "…"},
"home": "login:password"},
"default_account": "work"}}Старые переменные окружения продолжают работать: SWEB_ACCOUNTS_FILE (формат прежний:
{"имя": {"login","password"}} или {"имя": "login:password"}), SWEB_ACCOUNT, SWEB_TOKEN,
плюс SWEB_MIN_INTERVAL / SWEB_MAX_CONCURRENCY. Права: read свободно, write — confirm=true,
destructive/paid — CLOUD_READONLY=0 + CLOUD_ALLOW_DESTRUCTIVE=1 (старые SWEB_READONLY /
SWEB_ALLOW_DESTRUCTIVE тоже читаются).
Ошибки: [rpc] <код>: <сообщение>, -32603 лечится автоматическим re-login, 429 — ретраем.
Переход с sweb-mcp 0.1
Версия 0.2.0 — breaking change: 276 per-op тулов заменены пятью discovery-тулами. Те же методы
вызываются через cloud_call, имена операций не изменились.
Было (sweb-mcp 0.1) | Стало (cloud-mcp 0.2) |
|
|
|
|
|
|
|
|
|
|
|
|
Семейство
cloud-mcp — этот сервер: SpaceWeb, Timeweb, Selectel, Tilda за discovery-интерфейсом (сюда переехал sweb-mcp вместе с историей и issues);
timeweb-mcp — Timeweb (per-op tools + профили, предок движка).
Лицензия и disclaimer
MIT — см. LICENSE. Не аффилирован с Timeweb, Selectel, SpaceWeb и Tilda; товарные знаки
принадлежат владельцам. Снапшоты — переработанные фрагменты публичной документации провайдеров
(см. NOTICE).
Available Tools
5 toolscloud_callCDestructive
Execute an operation. Flat args are routed to path/query/header/body by the operation schema; 'confirm': true is required for write/destructive/paid
Inputs: tool (required), provider (required), confirm.
cloud_catalogCRead-only
Write a greppable catalog file (rules + one line per operation) for a provider
Inputs: provider (required), path.
cloud_describeCRead-only
Full parameter and body schema of one operation
Inputs: tool (required), provider (required).
cloud_providersBRead-only
Providers, their products, operation counts and credential state
Inputs: no named parameters.
cloud_searchARead-only
Find API operations across providers by a free-form query (RU or EN); returns the best matches with their tool names, methods and parameters
Inputs: query (required), top, kind, product, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools form a clear discovery pipeline: search finds operations, describe returns one operation's schema, call executes it, providers lists backends, catalog dumps to a file. The only mild overlap is between cloud_search and cloud_catalog, since both surface operation information, though 'writes a local file' differentiates the latter.
All five tools share the cloud_ namespace prefix with short, readable suffixes. There is a minor deviation where the first three use action verbs (search, describe, call) while the last two are nouns (providers, catalog), but the pattern remains predictable.
Five tools is a lean, well-scoped surface for a generic multi-provider API proxy where breadth lives in the catalog rather than in tool count. Each tool maps to a distinct step in the workflow and no tool seems redundant.
The read-inspect-execute lifecycle is covered, but there is no tool to set or refresh credentials (cloud_providers only reports credential state), and no obvious way to browse/paginate a provider's operations without a free-form query. These gaps will force agents into dead ends when auth is missing or when they want to enumerate the surface.
Maintenance
Related MCP Connectors
29 DNS, SEO, SSL, security, WHOIS & mail tools for AI agents. Pay per call (x402) or card API key.
100+ pay-per-call x402 tools for AI agents (web, company, crypto, media); 22,000+ APIs to search
Backend for AI agents: one batched tool over ~668 actions (hosting, storage, auth, payments).
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Plesk hosting environments through a set of standardized tools for security, health monitoring, DNS, email, backups, and service management.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage WHM hosting accounts and server administration tasks including account management, server stats, updates, SSL, backups, and email through a secure API.13ISC
- AlicenseCqualityBmaintenanceEnables AI agents to manage Beget hosting services through 73 tools covering the full Beget REST API, including sites, domains, DNS records, MySQL databases, FTP accounts, cron jobs, backups, mail and account statistics. It allows provisioning, configuration and rollback operations via natural language.733MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to query and manage a web hosting billing platform through its External API — clients, tickets, invoices, domains, orders, products, and system data. It defaults to read-only with per-domain opt-in for writes, two-step confirmation for billing and destructive actions, and automatic redaction of secrets, card data, and PII.1MIT