Timeweb MCP (stdio)

Lokaler MCP-Server für Timeweb Cloud via twc CLI.

Was Sie erhalten

• Nativer MCP stdio-Server (funktioniert mit Codex mcp_servers.<name>.command)

• Universelles Tool timeweb_run_cli für jeden twc-Befehl

• Fertige .env-Konfigurationsdatei

• Häufige Verknüpfungen für Server/Apps/Konto

Related MCP server: kwork-mcp

1) Abhängigkeiten installieren

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

2) Timeweb CLI konfigurieren

twc config

Wenn twc nicht im PATH ist, führen Sie Folgendes aus:

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

3) .env konfigurieren

Copy-Item .env.example .env -Force

Aktualisieren Sie bei Bedarf die Werte in .env.

4) Server zu Codex hinzufügen (~/.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

Starten Sie Codex nach dem Bearbeiten der Konfiguration neu.

5) Schneller Gesundheitscheck

Bitten Sie Codex, timeweb_whoami oder timeweb_account_status aufzurufen.

Haupt-Tools

• timeweb_run_cli(args, output_format, cwd) - führt jeden twc-Befehl aus

• 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)

Bereitstellungsbeispiele

App aus dem aktuellen Projekt erstellen:

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

Jeden CLI-Befehl ausführen:

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