Aspen Plusプロセスシミュレーション統合用のMCP(Model Context Protocol)サーバー。 このサーバーは、AIアシスタントが標準インターフェイスを介してAspen Plusシミュレーションと相互作用することを可能にします。

##特徴

-プロセスシミュレーション制御:Aspen Plusのシミュレーションのオープン、実行、および管理 -データアクセス:ストリームプロパティ、ブロックパラメータ、およびシミュレーション結果を読み書きする -Flowsheet マニピュレーション:装置ブロックおよびストリーム(強化モード)の作成、削除、接続

• 機器サポート:ミキサー、ヒーター、フラッシュ2、Rafrac、DSTWU、RPLUG、RCSTR、RYIELD -AIインテグレーション:Claudeや他のAIアシスタントをAspen Plusに接続

要件

• Python 3.10以上
• Windows OS(AspenプラスCOMインターフェイス用)
• アスペンプラスインストール
• pywin32パッケージ

インストール

1. このリポジトリをクローンする:

2. 仮想環境を作成します。

3. パッケージを取付けて下さい:

使用法

サーバーの実行

利用可能なツール

####基本モードツール

• [open_simulation - Aspen Plus シミュレーションファイル (set [use_enhanced: false]) を開きます。
• [run_simulation - 現在のシミュレーションを実行
• [get_value - ノードパスを使用してシミュレーションから値を取得する
• [set_value - シミュレーションで値を設定

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 
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