Troubleshoot BioSTEAM / QSDsan MCP

Run health_check from the same Python environment used by the MCP client. Confirm that BioSTEAM, ThermoSTEAM, QSDsan, and the server package are installed there.

Treat convergence as a process-model problem first. Review the thermodynamic package, stream specifications, recycle loops, unit parameters, and operating conditions before running uncertainty or optimization.

• For TEA, check scale, capacity, equipment sizing, operating hours, product stream, cost basis, and financial assumptions.
• For foreground impacts, check characterization-factor units, flow basis, operating hours, geography, temporal basis, and whether the intended background impacts are represented.

Use run_uncertainty_async or optimize_async and poll the returned job_id.

Version 0.4.1 checks the persisted runtime fingerprint before rebuilding a process handle. If the BioSTEAM, ThermoSTEAM, or QSDsan versions changed, rebuild the study under the new environment instead of forcing recovery.