# NX MCP

**用自然语言控制 Siemens NX 建模（text-to-CAD）。**

你说「建一个半径 50mm 的球、打个 10mm 的孔」，Claude 通过 NX Open API 在 NX 里完成建模，输出 `.prt` 文件。

> ⚠️ **当前状态：Demo（批量模式）。** 实时控制功能已规划但暂未打通，详见下方「已知问题」。

---

## 当前能做什么

已实测验证的建模能力：

| 操作 | 状态 |
|------|------|
| 新建 / 打开零件 | ✅ |
| 长方体、球体、圆柱体 | ✅ |
| 布尔运算（求差/合并） | ✅ |
| 圆角（EdgeBlend） | ✅ |
| 撤销（抑制特征） | ✅ |
| 保存 .prt | ✅ |
| 草图 / 拉伸 / 直接打孔 / 倒角 | ⏳ 未实现 |

**工作方式**：批量模式 —— Claude 生成 NX 脚本 → 后台调用 NX 引擎 → 生成/修改 `.prt` → 你用 NX 打开查看。缺点是每次看结果要重新打开文件。

---

## 环境要求

- **Siemens NX 2206**（本机装在 `D:\Program Files\Siemens\NX2206`，含 NX Open API）
- **Python 3.10+**
- **pip**

---

## 安装（仅实时模式需要，批量模式可跳过）

> 当前批量 demo **不需要**这一步。只有启用实时模式（MCP 服务器 + NX journal）时才需要安装。

```bash
pip install -e .
```

依赖：

| 依赖 | 用途 |
|------|------|
| `mcp>=1.0.0` | MCP SDK（实时模式用） |
| `httpx>=0.27.0` | HTTP 客户端（实时模式用） |

---

## 批量模式用法（当前可用）

`run_journal.exe` 启动独立后台 NX 会话执行脚本：

```bash
# 命令行：跑一个 NX journal 脚本
"D:/Program Files/Siemens/NX2206/NXBIN/run_journal.exe" "你的建模脚本.py"
```

脚本里用 NX Open API 建模并保存。核心模式：

```python
import NXOpen
session = NXOpen.Session.GetSession()
# 新建零件（或 OpenDisplay 打开已有零件）
wp = session.Parts.NewDisplay(r"输出路径.prt", NXOpen.PartUnits.Millimeters)
# ... 建模操作 ...
wp.Save(NXOpen.BasePart.SaveComponents.TrueValue, NXOpen.BasePart.CloseAfterSave.FalseValue)
```

**所有建模 API 的正确写法、签名和坑，见 [docs/nx-open-api-reference.md](docs/nx-open-api-reference.md)。** 开发前必读。

---

## 项目结构

```
nx_mcp_server.py      NX journal HTTP 服务器（实时模式组件）
nx_mcp/               MCP 服务器包（工具定义 + stdio 服务）
  ├── server.py         MCP 入口
  ├── nx_client.py      NX HTTP 客户端
  └── tools/            草图/特征/基础体工具定义
pyproject.toml        包配置
.mcp.json             Claude MCP 配置
docs/                 设计文档、实现计划、NX API 参考
tests/                集成测试
```

---

## 架构

**实时模式（目标，未打通）**：

```
Claude ←(stdio/MCP)→ MCP Server ←(HTTP)→ NX Journal 服务器 ←(NX Open)→ NX
```

- MCP 服务器通过标准 I/O 与 Claude 通信
- 把工具调用转成 HTTP 请求发给跑在 NX 里的 journal 服务器
- journal 用「队列 + threading.Event」保证 NX Open 只在主线程执行

**批量模式（当前）**：跳过 MCP 和 HTTP，直接生成脚本 → `run_journal.exe` 执行。

---

## 已知问题与后续计划

1. **实时模式卡点**：`ugraf.exe -journal` 在交互模式下不执行 journal；`run_journal.exe` 只能起独立后台会话。要让 journal 跑在用户交互式 NX 里，唯一办法是界面菜单 `Tools → Automation → Journal → Play`（需切到 Advanced 角色）。这是一次性设置，打通后实时模式即可用。
2. **待补命令**：草图、拉伸、旋转、直接打孔、倒角。API 已在 [docs/nx-open-api-reference.md](docs/nx-open-api-reference.md) 里备好结论。

---

## 版本

**V0.1（Demo）** —— 三维实体建模，批量模式。装配、制图、曲面建模不在当前范围。

**License:** MIT