MCP для Timeweb Cloud через twc CLI

Timeweb MCP (stdio)

Локальный MCP-сервер для Timeweb Cloud поверх официального CLI twc: готовые команды по серверам и приложениям плюс универсальный доступ к любой команде twc

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструменты останавливают и перезагружают серверы, а timeweb_run_cli выполняет любую команду twc без ограничений
  • Стоит начинать с ключа или сессии с минимально нужными правами и проверять команды перед выполнением через агента
Все причины и проверки
Российский стек

evgeninho69/timeweb-mcp

Официальный инструмент для того же сервиса: MCP-сервер Timeweb Cloud, 26 ★ репозитория

Установка

Работает в
Сервисы

Ручная установка

pip install -r requirements.txt && pip install -U twc-cli && twc config

Ставит зависимости и официальный CLI, затем авторизует его локально.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструменты останавливают и перезагружают серверы, а timeweb_run_cli выполняет любую команду twc без ограничений
  • Стоит начинать с ключа или сессии с минимально нужными правами и проверять команды перед выполнением через агента

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на 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

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

TIMEWEB_ENV_FILE обязательная
Путь к файлу .env с настройками сервера

Ограничения

Лицензии в репозитории нет. Инструмент timeweb_run_cli выполняет любую команду twc без ограничения списком разрешенных операций, включая потенциально разрушительные. README содержит примеры путей и логина конкретного пользователя Windows, что говорит о личном, не отполированном до релиза проекте. В репозитории закоммичены файлы server.err.log и server.out.log и папка __pycache__.

Как отключить. Удалите блок mcp_servers.timeweb из ~/.codex/config.toml и запись twc config для отзыва локальной сессии.

Частые вопросы

Можно ли выполнить команду twc, для которой нет отдельного инструмента?

Да, через timeweb_run_cli с произвольными аргументами args и форматом вывода output_format.

Как проверить, что сервер настроен верно?

Попросить агента вызвать timeweb_whoami или timeweb_account_status.

Обсуждение

Вопросов и отзывов пока нет.

MCP-сервер Timeweb Cloud

Timeweb Cloud MCP Server

Официальный

Официальный удаленный MCP Timeweb Cloud: серверы, базы данных, Kubernetes, домены, почта, S3 и биллинг аккаунта с обязательным подтверждением изменений

MCP-серверШирокий доступ26Звезды репозитория
Официальный

Официальный CLI и простой SDK для управления ресурсами Timeweb Cloud из терминала

CLIШирокий доступ71Звезды репозитория
Российский стек

MCP-сервер с полным охватом Timeweb Cloud API: серверы, базы данных, Kubernetes, S3, домены и DNS, SSH-ключи, floating IP и баланс

MCP-серверШирокий доступ
Российский стек

Широкий MCP-сервер для Timeweb Cloud: 245 инструментов по серверам, Kubernetes, базам данных, S3, доменам, почте и биллингу

MCP-серверШирокий доступ
Российский стек

Легкий MCP для доменов и DNS-записей классического хостинга Timeweb, требует отключенной двухфакторной авторизации на аккаунте

MCP-серверШирокий доступ

Коротко о README

README на английском дает пошаговую установку зависимостей и twc CLI, настройку twc config, копирование .env, конфигурацию mcp_servers.timeweb в Codex с таймаутами старта и вызова инструмента, быстрый health check через timeweb_whoami, список основных инструментов по серверам и приложениям и два примера вызова через timeweb_run_cli.

Бейдж для README

Сообщить о проблеме