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