OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:373-396 (handler)

  The handler for the 'orbstack_machine_list' MCP tool, which executes 'orb stack list' and returns the formatted output.

  @mcp.tool(
      name="orbstack_machine_list",
      annotations={
          "title": "列出 Linux 机器",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )
  async def orbstack_machine_list() -> str:
      """列出所有 OrbStack Linux 机器及其状态。
  
      显示机器名称、发行版、架构和运行状态。
  
      Returns:
          str: 机器列表信息
      """
      code, stdout, stderr = await _run_orb(["list"])
      if code != 0:
          return _format_error(stderr)
      if not stdout:
          return "当前没有 Linux 机器。使用 orbstack_machine_create 创建一个。"
      return f"Linux 机器列表:\n{stdout}"