Aspen Plus MCP Integration

Aspen Plus MCP 集成

Control Aspen Plus simulations via the Model Context Protocol (MCP).

通过模型上下文协议（MCP）控制 Aspen Plus 仿真。

See aspen-mcp/README.md for full documentation on available tools and block/stream reference.

有关可用工具及模块/流股参考的完整文档，请参阅 aspen-mcp/README.md。

Prerequisites

前置条件

• Windows (Aspen Plus only runs on Windows)
• Windows（Aspen Plus 仅在 Windows 上运行）
• Aspen Plus installed
• 已安装 Aspen Plus
• Python 3.11+
• Python 3.11+

Setup

安装配置

1. Install dependencies:
   安装依赖：

   pip install -r aspen-mcp/requirements.txt
   

1. Copy .mcp.json.example to .mcp.json:
   将 .mcp.json.example 复制为 .mcp.json：

   cp .mcp.json.example .mcp.json
   

1. Edit .mcp.json and update the path to server.py:
   编辑 .mcp.json 并更新 server.py 的路径：

   {
     "mcpServers": {
       "aspen-plus": {
         "command": "python",
         "args": ["path/to/aspen-mcp/server.py"]
       }
     }
   }
   

如果 python 不在系统 PATH 中，请使用 Python 可执行文件的完整路径：

   "command": "C:/Users/YourName/AppData/Local/Programs/Python/Python311/python.exe"
   

Privacy & Data Collection

隐私与数据收集

This project includes an optional, anonymous error-sharing feature to help the community resolve simulation issues faster.

本项目包含一个可选的匿名错误共享功能，帮助社区更快地解决仿真问题。

• What is collected: Error keyword, block type, property method, generalized cause description, fix direction (not specific values), Aspen path pattern, and failed attempts (generalized). All data is abstracted to pattern-level knowledge before submission.
• 收集内容：错误关键词、模块类型、物性方法、概括性原因描述、修复方向（非具体数值）、Aspen 路径模式以及失败尝试（概括性）。所有数据在提交前均被抽象为模式级知识。
• Opt-in only: After resolving a simulation error, you might be asked "Share this fix to community? (y/n)".
• 仅限主动选择加入：在解决仿真错误后，系统可能会询问"是否将此修复方案分享到社区？(y/n)"。
• Review process: All submissions go through human review before being published. A maintainer reviews each entry and only approved records are made available to other users.
• 审核流程：所有提交内容在发布前均经过人工审核。维护者会审核每条记录，只有通过审核的记录才会提供给其他用户。
• Local recording: Error resolutions are always saved locally to aspen-mcp/docs/error-history.md. This file never leaves your machine unless you commit and push it yourself.
• 本地记录：错误解决方案始终保存在本地 aspen-mcp/docs/error-history.md。除非您自行提交并推送，否则该文件不会离开您的机器。

License

许可证

This project is licensed under the MIT License.

本项目基于 MIT 许可证授权。