MCP для Timeweb Cloud через twc CLI
Timeweb MCP (stdio)
Локальный MCP-сервер для Timeweb Cloud поверх официального CLI twc: готовые команды по серверам и приложениям плюс универсальный доступ к любой команде twc
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты останавливают и перезагружают серверы, а timeweb_run_cli выполняет любую команду twc без ограничений
- Стоит начинать с ключа или сессии с минимально нужными правами и проверять команды перед выполнением через агента
Установка
Ручная установка
pip install -r requirements.txt && pip install -U twc-cli && twc configСтавит зависимости и официальный CLI, затем авторизует его локально.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Python оборачивает официальный CLI Timeweb Cloud twc и дает набор готовых инструментов: статус аккаунта, кто авторизован, список и карточка сервера, запуск, остановка и перезагрузка серверов (с опцией hard), список и карточка приложений, создание приложения из YAML-конфига. Кроме них есть универсальный инструмент timeweb_run_cli, который выполняет любую команду twc с произвольными аргументами и форматом вывода. Авторизация настраивается локально через twc config, сервер подключается к Codex как stdio-процесс через .env с путем к файлу конфигурации.
Для кого. Для тех, кто управляет серверами и приложениями Timeweb Cloud из Codex и хочет доступ ко всей поверхности CLI twc, а не только к готовым командам.
Подходит, если
- Нужно управлять серверами и приложениями Timeweb Cloud (запуск, остановка, перезагрузка, создание) из Codex
- Нужен доступ к командам twc, для которых еще нет отдельного инструмента, через timeweb_run_cli
- Уже используете официальный CLI twc и хотите тот же набор команд в агенте
Не подходит, если
- Нужен готовый npm-пакет или HTTP-транспорт: сервер локальный, stdio, устанавливается вручную из исходников
- Нужны инструменты для баз данных, Kubernetes, S3, доменов или DNS: этот сервер покрывает только серверы, приложения и аккаунт
- Важна предсказуемость набора команд: timeweb_run_cli пропускает произвольные аргументы CLI без ограничения списком безопасных операций
Пример запроса к агенту
Покажи мои серверы Timeweb Cloud и перезагрузи тот, что называется prod-appОграничения
Лицензии в репозитории нет. Инструмент timeweb_run_cli выполняет любую команду twc без ограничения списком разрешенных операций, включая потенциально разрушительные. README содержит примеры путей и логина конкретного пользователя Windows, что говорит о личном, не отполированном до релиза проекте. В репозитории закоммичены файлы server.err.log и server.out.log и папка __pycache__.
Как отключить. Удалите блок mcp_servers.timeweb из ~/.codex/config.toml и запись twc config для отзыва локальной сессии.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TIMEWEB_ENV_FILE обязательная | Путь к файлу .env с настройками сервера |
Проверка безопасности
- Инструменты останавливают и перезагружают серверы, а timeweb_run_cli выполняет любую команду twc без ограничений
- Стоит начинать с ключа или сессии с минимально нужными правами и проверять команды перед выполнением через агента
Коротко о README
README на английском дает пошаговую установку зависимостей и twc CLI, настройку twc config, копирование .env, конфигурацию mcp_servers.timeweb в Codex с таймаутами старта и вызова инструмента, быстрый health check через timeweb_whoami, список основных инструментов по серверам и приложениям и два примера вызова через timeweb_run_cli.
Частые вопросы
Можно ли выполнить команду twc, для которой нет отдельного инструмента?
Да, через timeweb_run_cli с произвольными аргументами args и форматом вывода output_format.
Как проверить, что сервер настроен верно?
Попросить агента вызвать timeweb_whoami или timeweb_account_status.
Похожие
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг