内容
# Creo J-Link MCP Server
基于 **J-Link (OTK Java Free)** 的 MCP 服务器，让 AI 智能体直接控制 PTC Creo Parametric 6.0+。
与 creoson-mcp 不同，本项目**直接通过 J-Link 连接 Creo**，无需 CREOSON 中间件。
```
AI Agent ←─ MCP (stdio) ─→ creo-jlink-mcp ←─ J-Link API ─→ Creo 6.0+
```
## 快速开始
### 1. 复制 J-Link JAR
将 Creo 安装目录中的 JAR 复制到 `libs/`：
```
<Creo>\Common Files\text\java\pfc.jar → libs/pfc.jar
<Creo>\Common Files\text\java\cipjava.jar → libs/cipjava.jar
```
### 2. 构建
```bash
gradlew.bat fatJar
```
### 3. 启动
```bash
set CREO_HOME=C:\Program Files\PTC\Creo 6.0.0.0\Common Files
scripts\start-mcp.bat
```
### 4. 配置 Claude Desktop
```json
{
"mcpServers": {
"creo-jlink": {
"command": "scripts/start-mcp.bat",
"cwd": "C:/path/to/creo-jlink-mcp",
"env": {
"CREO_HOME": "C:\\Program Files\\PTC\\Creo 6.0.0.0\\Common Files"
}
}
}
}
```
## 功能列表（96 个 MCP 工具）
| 类别 | 工具数 | 主要功能 |
|------|--------|----------|
| 连接管理 | 3 | 连接/断开 Creo、检查状态 |
| 会话操作 | 6 | 工作目录、配置选项、Mapkey 宏 |
| 文件/模型 | 10 | 打开、保存、关闭、重命名、再生、质量属性 |
| 特征 | 7 | 列出、删除、隐含、恢复、重命名 |
| 参数 | 7 | 列出、读取、设置、创建、删除 |
| 尺寸 | 3 | 列出、读取、设置尺寸值 |
| 装配 | 3 | 装配组件、BOM、组件列表 |
| 工程图 | 11 | 创建图纸、视图管理、比例设置 |
| 几何 | 4 | 包围盒、曲面、边、精度 |
| 导入导出 | 7 | STEP/IGES/STL/PDF/3D PDF/图片 |
| 族表 | 6 | 实例管理、表头、单元格读写 |
| 图层 | 4 | 列出、显示、隐藏、删除 |
| 注释 | 4 | 列出、读取、设置、删除 |
| 视图 | 3 | 列出、激活、保存视图 |
| 关系式 | 4 | 读写关系式、再生后关系式 |
| 材料 | 5 | 列出、设置、加载、删除 |
| 单位 | 3 | 读取、列出、设置单位制 |
| Windchill | 6 | 登录、工作区管理、签入 |
## 典型使用流程
```
creo_connect() → 连接 Creo
creo_open_file("part1.prt") → 打开零件
creo_set_parameter("WIDTH", "100") → 修改参数
creo_set_dimension(name="d0", value=50)→ 修改尺寸
creo_regenerate() → 再生模型
creo_export_step() → 导出 STEP
creo_save_file() → 保存
creo_disconnect() → 断开
```
## 兼容性
- **Creo 6.0+**（默认 6.0）
- Java 17+
- Windows
## License
MIT
