# aiax-mcps

**Repository Path**: stasterbai/aiax-mcps

## Basic Information

- **Project Name**: aiax-mcps
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIAX-MCPS

工业软件MCP工具集，为OpenClaw Agent提供与CAE软件的交互能力。

## 项目结构

```
aiax-mcps/
├── packages/
│   ├── core/                    # 核心共享库
│   │   ├── src/
│   │   │   ├── types.ts         # 类型定义
│   │   │   ├── errors.ts        # 错误处理
│   │   │   ├── logger.ts        # 日志系统
│   │   │   ├── adapter.ts       # 适配器基类
│   │   │   └── bridge.ts        # Python桥接
│   │   └── scripts/
│   │       └── bridge_server.py # Python桥接服务
│   │
│   ├── hypermesh-mcp/           # HyperMesh MCP Server
│   │   └── src/index.ts
│   │
│   ├── inspire-mcp/             # Inspire MCP Server
│   │   └── src/index.ts
│   │
│   └── abaqus-mcp/              # Abaqus MCP Server
│       └── src/index.ts
│
├── docs/                        # 文档
└── package.json
```

## 支持的软件

| 软件 | 包名 | 功能 |
|-----|------|------|
| **HyperMesh** | `@aiax-mcps/hypermesh-mcp` | 网格划分、前处理 |
| **Inspire** | `@aiax-mcps/inspire-mcp` | 拓扑优化、结构分析 |
| **Abaqus** | `@aiax-mcps/abaqus-mcp` | 有限元分析 |

## 安装

### 前置要求

- Node.js >= 18.0.0
- pnpm >= 8.0.0
- Python >= 3.10
- 目标CAE软件（HyperMesh/Inspire/Abaqus）

### 安装依赖

```bash
# 安装pnpm（如果未安装）
npm install -g pnpm

# 安装项目依赖
pnpm install

# 构建所有包
pnpm build
```

### 单独安装

```bash
# 仅构建核心库
pnpm build:core

# 仅构建HyperMesh MCP
pnpm build:hypermesh

# 仅构建Inspire MCP
pnpm build:inspire

# 仅构建Abaqus MCP
pnpm build:abaqus
```

## 配置

### OpenClaw集成

在OpenClaw的配置文件中添加MCP Server：

```json
{
  "mcpServers": {
    "hypermesh": {
      "command": "node",
      "args": ["/path/to/aiax-mcps/packages/hypermesh-mcp/dist/index.js"],
      "env": {
        "HYPERMESH_PATH": "C:\\Program Files\\Altair\\2024\\hwdesktop",
        "AIAX_LOG_LEVEL": "info"
      }
    },
    "inspire": {
      "command": "node",
      "args": ["/path/to/aiax-mcps/packages/inspire-mcp/dist/index.js"],
      "env": {
        "INSPIRE_PATH": "C:\\Program Files\\Altair\\2024\\hwdesktop",
        "AIAX_LOG_LEVEL": "info"
      }
    },
    "abaqus": {
      "command": "node",
      "args": ["/path/to/aiax-mcps/packages/abaqus-mcp/dist/index.js"],
      "env": {
        "ABAQUS_PATH": "C:\\SIMULIA\\Commands",
        "AIAX_LOG_LEVEL": "info"
      }
    }
  }
}
```

### 环境变量

| 变量名 | 说明 | 默认值 |
|-------|------|-------|
| `HYPERMESH_PATH` | HyperMesh安装路径 | `C:\Program Files\Altair\2024\hwdesktop` |
| `INSPIRE_PATH` | Inspire安装路径 | `C:\Program Files\Altair\2024\hwdesktop` |
| `ABAQUS_PATH` | Abaqus安装路径 | `C:\SIMULIA\Commands` |
| `AIAX_LOG_LEVEL` | 日志级别 | `info` |

## 工具列表

### HyperMesh工具

| 工具名称 | 功能描述 |
|---------|---------|
| `hm_import_geometry` | 导入几何文件 (IGES/STEP/Parasolid) |
| `hm_export_model` | 导出模型文件 |
| `hm_mesh_auto` | 自动网格划分 |
| `hm_mesh_2d` | 2D网格划分 |
| `hm_mesh_3d` | 3D网格划分 |
| `hm_mesh_quality` | 网格质量检查 |
| `hm_entity_select` | 实体选择 |
| `hm_create_set` | 创建Set |
| `hm_solver_export` | 导出求解器文件 |
| `hm_get_model_info` | 获取模型信息 |

### Inspire工具

| 工具名称 | 功能描述 |
|---------|---------|
| `ins_import_geometry` | 导入几何文件 |
| `ins_export_geometry` | 导出几何文件 |
| `ins_create_design_space` | 创建设计空间 |
| `ins_apply_load` | 施加载荷 |
| `ins_apply_constraint` | 施加约束 |
| `ins_run_optimization` | 运行拓扑优化 |
| `ins_run_analysis` | 运行分析 |
| `ins_get_results` | 获取结果 |

### Abaqus工具

| 工具名称 | 功能描述 |
|---------|---------|
| `abq_model_create` | 创建模型 |
| `abq_model_save` | 保存模型 |
| `abq_part_create` | 创建零件 |
| `abq_part_import` | 导入几何 |
| `abq_material_create` | 创建材料 |
| `abq_section_create` | 创建截面 |
| `abq_section_assign` | 分配截面 |
| `abq_assembly_create` | 创建装配 |
| `abq_step_create_static` | 创建静力分析步 |
| `abq_bc_create` | 创建边界条件 |
| `abq_load_create_force` | 创建力载荷 |
| `abq_load_create_pressure` | 创建压力载荷 |
| `abq_seed_part` | 设置网格种子 |
| `abq_mesh_generate` | 生成网格 |
| `abq_element_type` | 设置单元类型 |
| `abq_job_create` | 创建作业 |
| `abq_job_submit` | 提交作业 |
| `abq_job_status` | 查询作业状态 |
| `abq_odb_get_displacement` | 获取位移结果 |
| `abq_odb_get_stress` | 获取应力结果 |

## 使用示例

### HyperMesh网格划分

```
用户: 帮我对这个STEP文件进行网格划分

OpenClaw执行:
1. hm_import_geometry(file_path="model.step")
2. hm_mesh_auto(element_size=5.0, mesh_type="tetra")
3. hm_mesh_quality(criteria={...})
4. hm_solver_export(solver_type="abaqus", file_path="model.inp")
```

### Abaqus静力学分析

```
用户: 对这个零件做静力学分析

OpenClaw执行:
1. abq_model_create(name="Analysis")
2. abq_part_import(file_path="part.step")
3. abq_material_create(name="Steel", elastic={...})
4. abq_section_create(name="Section", material="Steel")
5. abq_assembly_create(part_name="Part-1")
6. abq_step_create_static(name="Load")
7. abq_bc_create(type="encastre", region=...)
8. abq_load_create_force(force=[0,0,-1000], region=...)
9. abq_seed_part(size=2.0)
10. abq_mesh_generate()
11. abq_job_create(name="Job-1")
12. abq_job_submit()
13. abq_odb_get_stress(odb_path="Job-1.odb")
```

## 开发

### 项目设置

```bash
# 克隆项目
git clone https://github.com/your-org/aiax-mcps.git
cd aiax-mcps

# 安装依赖
pnpm install

# 开发模式（监听变化）
pnpm dev
```

### 添加新软件支持

1. 在 `packages/` 下创建新的MCP包
2. 继承 `BaseAdapter` 类
3. 实现必要的工具方法
4. 更新 `bridge_server.py` 添加Handler
5. 编写文档

## 许可证

MIT License