Timeweb MCP (stdio)

通过 twc CLI 连接 Timeweb Cloud 的本地 MCP 服务器。

你将获得

• 原生 MCP stdio 服务器（适用于 Codex mcp_servers.<name>.command）

• 用于执行任何 twc 命令的通用工具 timeweb_run_cli

• 现成的 .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")