内容
sys MCP 服务器
[](https://www.python.org/)
[](https://opensource.org/licenses/MITMCP](https://img.shields.io/badge/MCP-2025.06.18-green.svg)](https://modelcontextprotocol.io/)
🌐 **语言：** **EN** | [РУС](README.ru.md) | [中文](README.zh.md)
---
**为 Claude Code CLI 提供直接控制 Ansys 工程仿真的能力。**
MCP（模型上下文协议）服务器将 PyAnsys 封装为 24 种工具，Claude Code 可以调用这些工具 - 在 Fluent 中运行 CFD，在 Mechanical 中进行有限元分析，在 MAPDL，在 DPF 中进行后处理，在 Prime 中进行网格划分。不需要在 Workbench 中点击。只需用纯语言描述您想要的内容。
> 🎯 **是什么让它与众不同：** 它不是聊天机器人包装器，也不是文档刮擦器。它为 Claude Code 提供了对 Ansys 求解器过程的真实编程访问权限 - 与 PyAnsys 内部使用的相同 API。在安装并许可 Ansys 的机器上，它实际上启动并控制求解器。
## 🎬 快速演示
```
用户：“模拟一个 10cm 管道，2m 长，入口速度 5 m钢壁，300K”
Claude Code（通过 Ansys MCP）：
1. ansys_examples（“pipe_flow”）← 找到合适的设置模式
2. ansys_mesh_generate（pipe.stp，...）← 生成 50 万单元格的网格
3. ansys_set_material（water，steel）← 分配材料
4. ansys_set_boundary_conditions（...）← 速度入口，压力出口
5. ansys_set_parameters（k-epsilon，...）← 配置湍流模型
6ys_run_simulation）← 启动 Fluent 并获得许可
7. ansys_get_convergence（）← 监测残差
ansys_get_field“velocity”）←速度场
9. ansys_export_resultsK）← 导出View
```
全部来自*。无需脚本，无UI 命令，无需 Workbench## 🚀2 分钟）
决条件
- Python10+
- 安装sys（FlMechanical 或 MAPDL）
- CLI
### 选项：单命令安装bash
#
git clone https://github.com/vorobjewsen/ansys-mcp-server.git
cd ansys-server
# 自动安装 + Code
./install # Linux / Mac
.bat # Windows安装程序：
1.venv` 虚拟环境
安装 `m SDK
3. 可 PyAnsys 包（.sh install-all` 获取）
4. 将 Claude写入 `~/./settings.json`
### 2：手动
# 1.环境
python3 - .venv && source ./activate
#. 安装 MCP SDK
pipcp
# 您的产品安装sys
pip install ansuent-core # CFD install ansys-mapdl-core # 结构 / APDL
pip install ansys-dpf-core # 后处理
pip install ansys-meshing-prime # 网格划分
# 4. 配置 Claude Code CLI（~/.claude/settings.json）
# 添加到 ~/.claude```
```json "mcpServers "ansys "command/to/ansys-mcp-server/.venv/bin "args-m", "anscp_server.server"],
cwd": "/path/toys-mcp-server/src }
}
bash
# 5启 Claude Code CLI — 完成！
```
### 3：pip 安装
pip install git+.com/vorsen30-max/-mcp-server.git
添加到 Claude Code 配置：
command": "anscp-server"
```
## 🧰 工具（共 24 个）
### 仿真管理
工具 | 功能 |
|------|-------------|
| `ansys_list_packages` | 检查已安装的 PyAnsys 包 |
| `ansys_run_simulation` | 启动仿真（Fluent / Mechanical / MAPDL） |
| `ansys_get_simulation_status` | 获取正在运行的仿真状态 |
| `ansys_stop_simulation` | 正常停止仿真 |
| `ansys_watch_simulation` | 实时监测收敛性 |
### 🔧 网格操作
| 工具 | 功能 |
|------|-------------|
| `ansys_mesh_info` | 获取信息（节点，单元， |
| `ansys_mesh_generate` |体生成网格（STP，IGES，SCDOC| `ansys_mesh` | 全局区域细化网格 |
ys_mesh_quality 运行质量诊断（偏纵横比 `ansys` | 在网格转换（MSH ↔ VTU） |
📊 结果处理
| | 功能 |
||
| `ansys_get` | 列出所有可用的结果字段 |
ansys_get_field_data` | 在探测点提取（应力，速度...） |
| `_export_results` |到 CSV / VTK5 / NPZ `ansys_get_con | 获取收敛残差） |
|ys_create_report`生成仿真报告/HTML/PDF） ⚙️ 模型配置
| 工具 | 功能 |
|------|-------------|
| `ansys_set_parameters` | 设置求解器设置，模型，数值 |
| `ansys_get_parameters` | 读取当前仿真参数 |
| `ansys_set_boundary_conditions` | 创建/修改边界条件（入口，出口，壁面，力...） |
| `ansys_list` |模型中的所有 |
| `_material` | 从库或自定义属性分配材料 `ansys_list_materials 浏览 An库 |
### 📖 帮助和文档
| | 功能 |
||
| `ansysation` | sys 文档（k，网格质量，收） |
| `_list_solvers` |求解器和 |
| `ans_setup` | 在运行设置中的常见错误 `ansys_examples` | 获取完整的实例（管道机翼空气动力） |
## 📦 支持的 Ansys 产品
| 产品 | PyAnsys 功能 |
|---------|----------------|
| **Fl | `ansys | CFD —，热传递，，多相流 **Mechanical** | `-core` | 有限元分析 — 热，模态，| **MAPDLansys-map` | 经典 AP 完整有限元分析 + 电磁学 |
DPF** | `-dpf-core` | 后处理 — 提取/转换结果数据 |
| **** | `ansys-meshing-prime`格划分 — 四面体，六面体，多，边界层 |
安装您需要的：
```bash
ansys-fluent-core # 仅 Fluent
ansys-mapdl-core # 仅 MAP# ... 或安装多个
pip install ansys-fluent-core ansys-dpf-core ansys-meshing-prime
```
## 🔐 许可
**MCP 服务器不直接处理许可。** PyAnsys 从标准环境中自动获取 Ansys 许可：
```bash
# 通常由 Ansys 安装程序设置：
export ANSYSLI_SERVER="1055@your-license-server"
export ANSYSLMD_LICENSE_FILE="1055@your-license-server"
# 或用于企业 PyPIM：
export ANSYS_PLATFORM_INSTANCEMANAGEMENT_CONFIG="/path/to/config"
```
如果 `fluent` 或 `mapdl` 在您的终端中有效，则 MCP 服务器也将有效。
## 🏗️ 架构
```
┌──────────────────────────────────────────────────────┐
│ Claude Code CLI │
│ “模拟管道流在 Re=10000...” │
└──────────────┬───────────────────────────────────────┘
│ stdio（JSON-RPC via MCP 协议）
┌──────────────▼───────────────────────────────────────┐
│ ansys-mcp-server（Python） │
│ ┌────────────────────────────────────────────────┐ │
│ │ 24 个 MCP 工具（Fluent，Mechanical，MAPDL，DPF） │ │
│ └──────────────────┬─────────────────────────────┘ │
│ │ Python API 调用 │
│ ┌──────────────────▼─────────────────────────────┐ │
│ │ AnsysClient（延迟加载 PyAnsys 包装器） │ │
│ └──────────────────┬─────────────────────────────┘ │
└─────────────────────┼────────────────────────────────┘
│
┌───────────┴───────────┐
│ PyAnsys │
│ （fluent / mapdl / │
│ mechanical / dpf） │
└───────────┬───────────┘
│
┌───────────▼───────────┐
│ Ansys 许可管理器 │
│ （SLI_SERVER） │
└───────────┬───────────┘
┌───────────▼───────────┐
Ansys 求解 │
│ （fluent / mapdl / │ mechanical │
└───────────────────────┘
```
##常见问题
**问：它在没有许可的情况下是否有效？**
服务器运行并且所有工具都响应指导和 API 示例。但是，实际求解器的 Ansys 许可有效许可的机器上，PyAnsys 自动获取它。
**问：支持哪些 Ansys 版本？：PyAnsys2024 R1版本（版本 ）。此服务器默认针对 R1（接受任何版本问：它可以在远程 HPC 集群上运行吗？**
答：是的 - PyAnsys 支持连接到远程 Fluent/Mechanical 实例ANSYS_PLATFORM_INSTANCAGEMENT_CONFIG`（PyPIM）进行配置。对于基于 Slurm 的 `ansys-map` 和 `launch(start_instance=False)` 并的求解器。
**问： Ansys/Syn 有关联吗？：否。这是一个社区项目。Ansys 和 Fluent 是 Ansys Inc. / Synopsys 的商标。
**问：Claude Code 可以运行完整的参数研究吗？**
答：是的。描述它：*“运行 10 个案例，入口速度从 1 到 10 m/s，收集压力降，”* - Claude循环中调用问：它现有的 ./.mechdb/.inp 文件一起使用吗：是的ys_run_sim 和 `input_file您现有的 几何体（.igesdoc），请ansys_load_geometry`。
**问：保存结果文件吗答：是的真后，结果输出目录： 编写 `.cas` + `.dat，Mechanical 编rst`，MAP写 `.rst/.`。您还ys_export_results，VTKDF5 或 NPZ 格式手动导出。
我可以获得格式？**
答ansys_export_results：**CSV** 分析），**VTK/VTU** （视化），DF5**二进制用于 ML 管道），**EnSight**处理器），**NP （NumPy）。以及 Markdown/DF 自动生成的报告问：它可以态（时间相关）吗？**
是的。通过 `_set_parameters` 设置时间参数，值为 `{"time": "trans "time_step0.01,_time_steps":}`。然后使用 `_get_field_dataansys_export，并使用 `` 参数提取特定长的数据。
**问：有哪些湍流？**
答：/MAPDL-ε（标准NG，实现），k-ω（标准，SST），Spalart-Allmaras，雷诺应力，LES，DES。描述您需要的，Claude Code 将配置正确的模型。
**问：它可以进行多相仿真吗？**
答：是的 - Fluent 支持 VOF，欧混合和 DPM。告诉 Claude Code：*“设置 VOF用于水-空气”*，它将通过 `ansys` 配置适当的设置。
**问：它支持来自 SolidWorks / Catia / NX / Fusion 360 的 CAD 几何体吗？**
答：是的。将您的 CAD 导出为 `.stp` 或 `.iges`（标准交换格式），然后使用 `ansys_load_geometry`主要的 CAD 工具都支持 STEPES 导出。
**问：我可以在 在 Linux 上运行时 上使用它吗？**
答：是的。MCP 服务器在 Claude Code 运行的任何地方 Ansys 在 Linux 工作站上，安装 MCP 服务器并运行 Claude Code（或 Claude Desktop）连接到您还可以使用隧道。
**仿真发散**
答：Cl诊断并修复它敛失败，`ansys_get_con 显示哪些方程有 Code 可以调整松弛因子，切换到一阶方案，或细化网格 - 所有这些现有的工具。
**问：多个用户可以共享一个 Ansys 许可吗？**
答：服务器不管理许可队列 - 这就是 Ansys 许可管理器的工作。如果您的许可服务器有 N 个席位，最多可以同时运行 N 个仿真。超过该限制，PyAnsys 将返回许可错误。
**问：有限制速率或使用配额吗？**
答：否 - MCP 服务器没有人为限制。唯一的限制是您的硬件（CPU 核心，RAM）和 Ansys 许可计数。Claude Code 将愉快地运行 100 个仿真，如果您要求它这样做 - 所以请具体说明您想要的内容。
**问：它可以在笔记本电脑上运行吗？**
答：是的，用于小型到中型模型。具有 16GB RAM 的笔记本电脑可以处理多达 ~2-5 百万单元的网格用于 CFD 或 ~500k 节点用于有限元分析。学生许可与此服务器配合使用。
**问：重启 PC 后，我需要手动重启 MCP 服务器吗？**
答：否。如果您通过 `settings.json` 配置了它（`install.sh` 自动执行此操作），Claude Code CLI 在启动时启动 MCP 服务器。只需打开 Claude Code，它就生效了。要手动测试：`./install.sh run`（或 `source .venv/bin/activate && cd src && python -m ansys_mcp_server.server`）。
**问：如何检查服务器是否正在运行？**
答：在 Claude Code 中，询问：*“已安装哪些 Ansys 包？”* - 如果它响应，则服务器处于活动状态。您还可以检查终端中是否有任何 Python 进程正在运行 `ansys_mcp_server.server`。如果出现问题，请验证 `~/.claude/settings.json` 中的指向正确的 `.venv`。
## 贡献
```git clone https://github.com/vorobj30-max/ans-server.git
ys-mcp# 创建分支，进行发送 PR
```
📄 许可
MIT - 使用它，fork 它，发布它。
---
🤖 为 [Claude Code](https://claude.ai/code) 构建 · 由 [PyAnsys](https://docs.pyansys.com) 提供支持 · MCP 协议
