OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:285-296 (handler)

  The handler function `orbstack_status` executes the `orb status` command and returns the output.

  async def orbstack_status() -> str:
      """获取 OrbStack 的运行状态信息。
  
      返回 OrbStack 是否正在运行、版本等基本状态。
  
      Returns:
          str: OrbStack 状态信息
      """
      code, stdout, stderr = await _run_orb(["status"])
      if code != 0:
          return _format_error(stderr, "请确认 OrbStack 已安装: brew install orbstack")
      return f"OrbStack 状态:\n{stdout}"

• src/orbstack_mcp/server.py:275-284 (registration)

  Registration of the `orbstack_status` tool using the @mcp.tool decorator.

  @mcp.tool(
      name="orbstack_status",
      annotations={
          "title": "OrbStack 状态查询",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )