Timeweb MCP (stdio)

Servidor MCP local para Timeweb Cloud a través de la CLI twc.

Qué obtienes

• Servidor MCP stdio nativo (funciona con mcp_servers.<name>.command de Codex)

• Herramienta universal timeweb_run_cli para cualquier comando twc

• Archivo de configuración .env listo para usar

• Accesos directos comunes para servidores/aplicaciones/cuenta

Related MCP server: kwork-mcp

1) Instalar dependencias

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

2) Configurar la CLI de Timeweb

twc config

Si twc no está en el PATH, ejecuta:

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

3) Configurar .env

Copy-Item .env.example .env -Force

Actualiza los valores en .env si es necesario.

4) Añadir el servidor a 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

Reinicia Codex después de editar la configuración.

5) Comprobación rápida de estado

Pide a Codex que llame a timeweb_whoami o timeweb_account_status.

Herramientas principales

• timeweb_run_cli(args, output_format, cwd) - ejecuta cualquier comando 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)

Ejemplos de despliegue

Crear una aplicación desde el proyecto actual:

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

Ejecutar cualquier comando de la CLI:

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