HYSYS MCP Server

MCP serverCommunity

51 HYSYS tools over COM; by default it only reads and saves cases, and writes must be switched on. By yuuyo-arobet.

6 starsUpdated 5 months agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: Aspen HYSYS
How it connects: Drives a running copy of the tool
Access: Read-only or read-write (configurable)
Tool versions: Aspen HYSYS V12 or later (tested on V14)
Operating systems: Windows
Needs a Aspen HYSYS licence: Yes
Transport: Local (stdio)
AI clients documented: Claude Code, Claude Desktop
Licence: MIT
Language: Python

What it can do

Reads streams, unit operations, column profiles and specs, components, fluid packages and solver status, and checks material balances.
Opens, closes and saves cases and switches between open cases and HYSYS instances.
With writes enabled, changes stream conditions and unit parameters, runs the solver, adjusts column specs and runs case studies.
Creates, connects and deletes streams and unit operations; build tools do a dry run unless you confirm.

Limitations

Windows only; the server needs native Windows Python, though Claude Code itself can run in WSL.
The author warns that write tools can freeze HYSYS, which is why the default mode hides them.
Building needs a case that already has components and a fluid package, and disconnecting a stream isn't possible through the V14 COM interface.
The README is mainly in Japanese, with a short English summary.

Install

cd path\to\hysys-mcp
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -e .

Source: github.com/yuuyo-arobet/AspenHYSYS-MCP-Server

{
  "mcpServers": {
    "hysys": {
      "command": "C:\\path\\to\\hysys-mcp\\venv\\Scripts\\python.exe",
      "args": ["-m", "hysys_mcp.server"],
      "env": { "HYSYS_MCP_MODE": "enhanced" }
    }
  }
}

Source: github.com/yuuyo-arobet/AspenHYSYS-MCP-Server

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.