AspenPlus MCP Server

MCP (Model Context Protocol) server for Aspen Plus process simulation integration. This server enables AI assistants to interact with Aspen Plus simulations through a standardized interface.

Features

• Process Simulation Control: Open, run, and manage Aspen Plus simulations
• Data Access: Read and write stream properties, block parameters, and simulation results
• Flowsheet Manipulation: Create, delete, and connect equipment blocks and streams (enhanced mode)
• Equipment Support: Mixer, Heater, Flash2, Radfrac, DSTWU, RPLUG, RCSTR, RYIELD
• AI Integration: Connect Claude and other AI assistants to Aspen Plus

Requirements

• Python 3.10 or higher
• Windows OS (for Aspen Plus COM interface)
• Aspen Plus installed
• pywin32 package

Installation

1. Clone this repository:

git clone <repository-url>
cd AspenPlus-MCP-Server

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the package:

pip install -e .

Usage

Running the Server

python -m aspenplus_mcp.server

Available Tools

Basic Mode Tools

• open_simulation - Open an Aspen Plus simulation file (set use_enhanced: false)
• run_simulation - Run the current simulation
• get_value - Get a value from the simulation using a node path
• set_value - Set a value in the simulation
• close_simulation - Close the current simulation

Enhanced Mode Tools (requires use_enhanced: true)

• place_block - Add a new equipment block to the flowsheet
• delete_block - Remove an equipment block from the flowsheet
• place_stream - Add a new stream to the flowsheet
• connect_stream - Connect a stream to a block port
• save_simulation - Save the simulation to file

Example Node Paths

# Stream temperature
\\Data\\Streams\\S1\\Output\\TEMP_OUT\\MIXED\\MIXED

# Block parameter
\\Data\\Blocks\\B1\\Input\\TEMP

# Component flow rate
\\Data\\Streams\\S1\\Output\\MOLEFLOW\\MIXED\\WATER

Development

Install development dependencies:

pip install -e ".[dev]"

Run tests:

pytest

Format code:

black src/

Configuration with Claude Desktop

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aspenplus": {
      "command": "C:\\path\\to\\AspenPlus-MCP-Server\\venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "aspenplus_mcp.server"
      ]
    }
  }
}

Important Notes:

• Use the full absolute path to your virtual environment's Python executable
• On Windows, use double backslashes (\\) in paths or forward slashes (/)
• After editing the config file, restart Claude Desktop completely
• The MCP server will start automatically when Claude Desktop launches

Usage Examples

Basic Mode - Reading/Writing Values

# Open simulation in basic mode
open_simulation(filepath="C:/simulations/myprocess.bkp", use_enhanced=False)

# Read stream temperature
get_value(path="\\Data\\Streams\\S1\\Output\\TEMP_OUT\\MIXED\\MIXED")

# Set feed temperature
set_value(path="\\Data\\Streams\\FEED\\Input\\TEMP", value=25.0)

# Run simulation
run_simulation()

Enhanced Mode - Flowsheet Editing

# Open simulation in enhanced mode
open_simulation(filepath="C:/simulations/myprocess.bkp", use_enhanced=True)

# Add a mixer block
place_block(block_name="MIX-01", equipment_type="Mixer")

# Add streams
place_stream(stream_name="STREAM-1", stream_type="MATERIAL")
place_stream(stream_name="STREAM-2", stream_type="MATERIAL")

# Connect streams to mixer
connect_stream(block_name="MIX-01", stream_name="STREAM-1", port_name="IN1")
connect_stream(block_name="MIX-01", stream_name="STREAM-2", port_name="IN2")

# Save changes
save_simulation()

Credits

This project integrates the AspenPlus-Python-Interface by Richard ten Hagen for advanced flowsheet manipulation capabilities.

License

MIT