cloud-mcp
Provides read-only integration with Tilda Publishing's export API, enabling export of sites and pages, checking export status, and retrieving export links. It is disabled by default and requires a Tilda Business plan for API access.
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., "@cloud-mcp reboot my Timeweb Cloud server with ID 12345"
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) сразу для нескольких облачных провайдеров: Timeweb Cloud (515
операций), Selectel (31 продукт, 746 операций), Tilda Publishing (10). Провайдер —
аргумент вызова, а не переменная окружения: переключение без рестарта и без обхода кэша
tools/list у клиента.
Вместо сотен 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: cloud-chat-assistant
Установка
cd cloud-mcp
python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
python scripts/sync_specs.py # обновить снапшоты API из документации провайдеровУчётные данные
Один файл на все провайдеры — 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).
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, по требованию.
Семейство
sweb-mcp — SpaceWeb (per-op tools);
timeweb-mcp — Timeweb (per-op tools + профили, в этом репо предок движка);
cloud-mcp — этот сервер: несколько провайдеров за discovery-интерфейсом.
Лицензия и disclaimer
MIT — см. LICENSE. Не аффилирован с Timeweb, Selectel и Tilda; товарные знаки принадлежат
владельцам. Снапшоты — переработанные фрагменты публичной документации провайдеров.
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
Each tool targets a distinct step: search discovers operations, describe returns one operation's schema, call executes, providers lists accounts/credentials, catalog writes a file. The only mild overlap is between cloud_search (find operations) and cloud_catalog (enumerate operations into a file), but the output-medium distinction is stated clearly enough.
All names share a consistent cloud_ prefix and snake_case style. However the suffixes mix verbs (search, describe, call) with nouns (providers, catalog), so the verb_noun pattern isn't strictly uniform, though it remains predictable and readable.
Five tools is a tight, well-scoped set for a generic multi-provider API gateway: discover, inspect, invoke, list context, and export. No tool feels redundant and there is no obvious missing piece at this layer.
The search→describe→call pipeline covers the full discovery-to-execution lifecycle, and providers/catalog fill in context and offline grep workflows. Minor gaps remain: no way to set/refresh credentials (only view state) and no built-in pagination or batch handling, though agents can work around these.
Maintenance
Related MCP Connectors
Unified API to query AWS, GCP, Azure and generate Terraform/CLI execution kits for AI agents.
Backend for AI agents: one batched tool over ~668 actions (hosting, storage, auth, payments).
Create, list and destroy hourly-billed servers on Vultr, DigitalOcean, Hetzner and Linode.
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA cloud replacement for mcp-server-filesystem that provides 30 tools for S3, Azure Blob, and Google Cloud Storage, deployable locally via STDIO or remotely over HTTP/WebSocket with OAuth 2.1 authentication.137 npm3-
- FlicenseNot gradedqualityCmaintenanceMulti-cloud MCP server that exposes cloud AI models as tools for AI CLI agents, supporting streaming, conversation history, parallel multi-model queries, and dynamic model discovery.2-
- AlicenseBqualityCmaintenanceA local stdio MCP server that provides 69 tools for Cloudflare REST API v4, including DNS, Zones, Workers, KV, R2, D1, Pages, Queues, Tunnels, SSL, WAF, Email Routing, Logpush and Workers AI, authenticated by a single API token.6966 npm3MIT
- AlicenseAqualityBmaintenanceAggregates dozens of upstream MCP servers behind a single stdio gateway and lazily loads tool schemas on demand, enabling clients to search, describe, and invoke tools while cutting Turn-0 token usage by 85–95%.4MIT