Catia V5 MCP Server

CATIA V5 MCP服务器

通过模型上下文协议（MCP）将Claude AI连接到达索系统CATIA V5。

CATIA V5的第一个开源MCP服务器。使用自然语言从Claude Desktop或Claude Code驱动CATIA V5 CAD建模。

它做什么

此MCP服务器公开 50+工具 这让克劳德：

• 创建和管理文档 --新零件、产品（组件）、打开、保存、关闭
• 二维草图 --直线、矩形、圆、圆弧、样条曲线、点、约束
• 零件设计 --衬垫、口袋、轴、凹槽、圆角、倒角、孔、外壳、拔模斜度、厚度、图案（矩形/圆形）、镜子
• 装配 --添加组件、固定/重合/偏移/角度约束、移动/旋转
• 测量 --距离、惯性、边界框、参数
• 出口 --STEP、IGES、STL、3DXML、VRML、截图
• 视图控制 --设置标准视图，适合所有人，捕捉屏幕截图

需求

• 视窗 （COM自动化仅适用于Windows）
• CATIA V5 已安装并获得许可（R2016+）
• Python 3.10+
• 克劳德桌面版 或 克劳德代码

快速安装（推荐）

git clone https://github.com/daiemon12/catia-v5-mcp-server.git
cd catia-v5-mcp-server
bash setup.sh

该脚本处理一切：依赖关系、Claude Desktop配置和验证。

手动安装

1.克隆存储库

git clone https://github.com/daiemon12/catia-v5-mcp-server.git
cd catia-v5-mcp-server

2.安装依赖项

pip install -e .

或手动：

pip install mcp pywin32

3.配置克劳德桌面

编辑您的Claude Desktop配置文件：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

添加服务器：

{
  "mcpServers": {
    "catia-v5": {
      "command": "python",
      "args": ["-m", "catia_mcp"]
    }
  }
}

或者使用绝对路径：

{
  "mcpServers": {
    "catia-v5": {
      "command": "python",
      "args": ["C:/path/to/catia-v5-mcp-server/catia_mcp/server.py"]
    }
  }
}

4.克劳德代码

claude mcp add catia-v5 python -- -m catia_mcp

5.启动CATIA V5

在要求Claude与CATIA V5交互之前，请确保CATIA V5正在运行。服务器将自动连接到正在运行的实例。

如果CATIA V5未运行，服务器将尝试启动它（要求CATIA注册为COM服务器： cnext.exe /regserver).

用法示例

配置后，只需与Claude交谈：

创建一个简单的零件

创建一个新的CATIA零件。在XY平面上以原点为中心绘制一个100x60mm的矩形，然后将其拉伸40mm

设计支架

“设计一个安装支架：从一个120x80mm厚的5mm底板开始。在拐角处添加4个M6安装孔，边缘距离为10mm。然后添加两个30mm高的垂直肋。”

参数修改

“显示活动部件的所有参数。然后将焊盘高度更改为60mm。”

出口制造业

“将当前零件导出为C:/Export/packets.tp中的STEP格式，并对等轴测视图进行截图。”

装配

创建一个新部件。添加C:\\parts/bracket.CATPart中的括号和C:\\parts/base.CATPart中的基座。修复基座，然后在两者之间创建重合约束

建筑

catia-v5-mcp-server/
├── catia_mcp/
│   ├── __init__.py
│   ├── __main__.py          # python -m catia_mcp entry point
│   ├── server.py            # MCP Server — tool registration & routing
│   ├── connection.py        # COM connection manager (win32com)
│   └── tools/
│       ├── __init__.py
│       ├── document.py      # Document management (9 tools)
│       ├── sketcher.py      # 2D Sketch tools (11 tools)
│       ├── part_design.py   # 3D Part Design features (15 tools)
│       ├── assembly.py      # Assembly/Product tools (9 tools)
│       ├── measurement.py   # Measurement & analysis (6 tools)
│       └── export.py        # Export & view control (4 tools)
├── pyproject.toml
├── requirements.txt
└── README.md

运作原理

Claude (Desktop/Code)
    │
    │ stdio (MCP JSON-RPC)
    ▼
catia_mcp/server.py (MCP Server)
    │
    │ Tool routing
    ▼
catia_mcp/tools/*.py (Tool modules)
    │
    │ win32com.client (COM Automation)
    ▼
CATIA V5 Application

1. Claude通过stdio发送MCP工具调用
2. 服务器将每次调用路由到相应的工具模块
3. 每个工具模块使用 win32com.client 通过COM驱动CATIA V5
4. 结果（JSON，文本）返回给Claude

工具参考

文档工具（9）

素描工具（11）

零件设计工具（15）

装配工具（9）

测量工具（6）

导出工具（4）

故障排除

“未安装pywin32”

pip install pywin32

此服务器需要Windows。它无法在macOS或Linux上运行。

“无法连接到CATIA V5”

1. 确保CATIA V5正在运行
2. 将CATIA注册为COM服务器：导航到 C:\Program Files\Dassault Systemes\B\\code\bin\ 然后跑 cnext.exe /regserver
3. 检查是否没有模态对话框阻塞CATIA

“没有活动文档”

首先使用创建或打开文档 catia_new_part 或 catia_open_document.

COM ByRef数组限制

某些测量方法可能不适用于后期绑定。如果遇到问题，请尝试使用 pycatia 作为替代后端（欢迎贡献）。

贡献

这个项目是开源的。欢迎捐款：

• 线框和曲面（GSD） 工具
• 绘图 工具（二维绘图）
• 智件 （公式、规则、检查）
• pycatia后端 作为原始win32com的替代品
• 测试 COM模拟
• 3d体验 CATIA支持

许可证

麻省理工学院

学分

灵感来源：

• SolidWorks MCP
• freecad mcp
• abaqus-mcp服务器
• 皮卡蒂亚