OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:1018-1027 (handler)

  The handler function that executes the `orbstack k8s status` command to retrieve the status of the Kubernetes cluster.

  async def orbstack_k8s_status() -> str:
      """查看 OrbStack Kubernetes 集群的状态。
  
      Returns:
          str: K8s 集群状态
      """
      code, stdout, stderr = await _run_orb(["k8s", "status"])
      if code != 0:
          return _format_error(stderr)
      return f"Kubernetes 状态:\n{stdout}" if stdout else "Kubernetes 状态: 未运行"

• src/orbstack_mcp/server.py:1008-1016 (registration)

  The registration decorator that defines the `orbstack_k8s_status` tool in the MCP server.

  @mcp.tool(
      name="orbstack_k8s_status",
      annotations={
          "title": "Kubernetes 状态",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },