OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:331-342 (handler)

  The implementation of the orbstack_start tool handler, which runs `orbstack start` via _run_orb and returns the result.

  async def orbstack_start() -> str:
      """启动 OrbStack 服务。
  
      如果 OrbStack 已在运行，此操作无副作用。
  
      Returns:
          str: 启动结果
      """
      code, stdout, stderr = await _run_orb(["start"])
      if code != 0:
          return _format_error(stderr)
      return "OrbStack 已启动" + (f"\n{stdout}" if stdout else "")

• src/orbstack_mcp/server.py:321-330 (registration)

  The MCP tool registration for orbstack_start using the @mcp.tool decorator.

  @mcp.tool(
      name="orbstack_start",
      annotations={
          "title": "启动 OrbStack",
          "readOnlyHint": False,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )