OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:588-607 (handler)

  The implementation of the orbstack_machine_push tool handler.

  async def orbstack_machine_push(params: MachineFileTransferInput) -> str:
      """将文件从 macOS 推送到 Linux 机器。
  
      Args:
          params: 包含源文件路径、可选的目标路径和机器名
  
      Returns:
          str: 传输结果
      """
      args = ["push"]
      if params.machine:
          args.extend(["-m", params.machine])
      args.append(params.source)
      if params.destination:
          args.append(params.destination)
  
      code, stdout, stderr = await _run_orb(args)
      if code != 0:
          return _format_error(stderr)
      return f"文件已推送: {params.source}" + (f" -> {params.destination}" if params.destination else "")

• src/orbstack_mcp/server.py:578-587 (registration)

  Registration of the orbstack_machine_push tool using the @mcp.tool decorator.

  @mcp.tool(
      name="orbstack_machine_push",
      annotations={
          "title": "推送文件到 Linux 机器",
          "readOnlyHint": False,
          "destructiveHint": False,
          "idempotentHint": False,
          "openWorldHint": False,
      },
  )