Timeweb MCP (stdio)

Локальный MCP-сервер для Timeweb Cloud через CLI twc.

Что вы получаете

• Нативный MCP stdio-сервер (работает с mcp_servers.<name>.command в Codex)

• Универсальный инструмент timeweb_run_cli для любой команды twc

• Готовый файл конфигурации .env

• Полезные быстрые команды для серверов/приложений/аккаунта

Related MCP server: kwork-mcp

1) Установка зависимостей

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

2) Настройка Timeweb CLI

twc config

Если twc отсутствует в PATH, выполните:

& "C:\Users\ZotkinEA\AppData\Roaming\Python\Python313\Scripts\twc.exe" config

3) Настройка .env

Copy-Item .env.example .env -Force

При необходимости обновите значения в .env.

4) Добавление сервера в Codex (~/.codex/config.toml)

[mcp_servers.timeweb]
command = "python"
args = ["D:\\11. 2KAD_Soft\\0.1 Skills\\timeweb-mcp\\server.py"]
env = { TIMEWEB_ENV_FILE = "D:\\11. 2KAD_Soft\\0.1 Skills\\timeweb-mcp\\.env" }
startup_timeout_sec = 20
tool_timeout_sec = 240

Перезапустите Codex после редактирования конфигурации.

5) Быстрая проверка работоспособности

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

Основные инструменты

• timeweb_run_cli(args, output_format, cwd) — выполнение любой команды twc

• timeweb_account_status()

• timeweb_whoami()

• timeweb_list_servers(filter_expr)

• timeweb_get_server(server_id)

• timeweb_start_server(server_ids)

• timeweb_stop_server(server_ids, hard)

• timeweb_reboot_server(server_ids, hard)

• timeweb_list_apps(filter_expr)

• timeweb_get_app(app_id, wait_started)

• timeweb_create_app(config_path, wait_started)

Примеры использования

Создание приложения из текущего проекта:

timeweb_run_cli(args=["apps", "create", "./timeweb-app.yaml"], output_format="json")

Выполнение любой команды CLI:

timeweb_run_cli(args=["cluster", "list"], output_format="json")