OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:448-460 (handler)

  The handler function that executes the "orbstack_machine_start" tool by calling `_run_orb` with the start command.

  async def orbstack_machine_start(params: MachineNameInput) -> str:
      """启动指定的 Linux 机器。
  
      Args:
          params: 包含机器名称
  
      Returns:
          str: 启动结果
      """
      code, stdout, stderr = await _run_orb(["start", params.name])
      if code != 0:
          return _format_error(stderr, "使用 orbstack_machine_list 查看可用机器")
      return f"机器 '{params.name}' 已启动"

• src/orbstack_mcp/server.py:438-446 (registration)

  Registration of the "orbstack_machine_start" tool using the @mcp.tool decorator.

  @mcp.tool(
      name="orbstack_machine_start",
      annotations={
          "title": "启动 Linux 机器",
          "readOnlyHint": False,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },