OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:515-539 (handler)

  The `orbstack_machine_info` tool definition and handler implementation. It uses `_run_orb` to fetch details for a specified machine.

  @mcp.tool(
      name="orbstack_machine_info",
      annotations={
          "title": "查看 Linux 机器详情",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )
  async def orbstack_machine_info(params: MachineNameInput) -> str:
      """获取指定 Linux 机器的详细信息。
  
      包括发行版、架构、状态、IP 地址等。
  
      Args:
          params: 包含机器名称
  
      Returns:
          str: 机器详细信息
      """
      code, stdout, stderr = await _run_orb(["info", params.name])
      if code != 0:
          return _format_error(stderr)
      return f"机器 '{params.name}' 详情:\n{stdout}"

• src/orbstack_mcp/server.py:112-119 (schema)

  The `MachineNameInput` schema used by `orbstack_machine_info` and other tools, which validates the machine name input.

  class MachineNameInput(BaseModel):
      """需要机器名称的输入参数"""
      model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
  
      name: str = Field(
          ...,
          description="Linux 机器的名称",
          min_length=1,