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