内容
MCP
通过Claude使用自然语言控制Aut 360。FusionMCP是一个 [MCP（模型上下文协议）](https://modelcontextprotocol.io/) 服务器，它让Claude可以直接访问Fusion 360的CAD引擎——草图、建模、装配等。
## 工作原理
```
Claude Desktop ──stdio──▶ Server (Python) ──HTTP──▶ Fusion 360 插件
fusion_server.py FusionMCP.py
（您的机器） （在Fusion 360内）
```
1. **MCP 服务器** (`mcp_server/fusion_server.py`) — 在本地运行，通过stdio向Claude公开模型上下文协议2. **Fusion 360 插件**MCP.py 在Fusion 360内运行，监听 `http://127.0.0.1:7432`，接收来自MCP服务器的命令，并使用Fusion 360 Python API在Fusion的主线程上执行它们。
## 功能
图
- 基本图形：矩形，中心矩形，线，弧，多边形，椭圆，样条曲线，文本
- 操作：圆角，偏移，镜像，阵列
- 约束：重合，切线，垂直，平行，水平，垂直，同心，等长，中点，固定，共线，光滑
- 尺寸：距离，角度，直径，半径
### 3D 建模
- 拉伸，旋转， loft，扫描，螺旋，管道
- 外壳，圆角，倒角，拔模，螺纹
- 按/拉面，加厚草图
- 布尔联合，减，交）
- 移动，旋转，缩放（均匀和非均匀），复制，镜像 矩形和圆形体阵列
- 孔简单，沉头， counters
### 装配
-，在组件之间移动- 连接：刚性，旋转，滑动，圆柱-槽，平面，球
- 装配中### 检查
- 设计信息（组件，草图，实体，参数，连接）
- 面/边/草图信息，用于有针对性的操作
- 实体测量（边界框，体积，面/边/顶点计数）
- 实体之间的距离测量
- 特征时间线
### 参数和外观
- 创建和更新用户参数
- 从Fusion库应用材质外观
- 在实体上设置自定义RGB颜色
### 导出和捕获
- STL，STEP，3MF，F3D（Fusion存档）
- 视口截图捕获
### 其他
- 在Fusion 360中执行任意Python脚本
- 创建/清除文档
- 撤销/重做
- 保存/另存为
## 先决条件
- [Autodesk Fusion 360](https://www.autodesk.com/products/fusion-360) （任意许可级别）
- [Python 3.10+](https://www.python.org/downloads/)
- [Claude Desktop](https://claude.ai/download)
## 安装
### 1. 克隆仓库
```bash
git clone https://github.com/Anonimus124/fusion-mcp.git
cd fusion-mcp
```
### 2. 安装Python依赖项
```bash
pip install -r mcp_server/requirements.txt
```
这将安装：
- `mcp` — 模型上下文协议SDK
- `requests` — 用于与Fusion插件通信的HTTP客户端
### 3. 安装Fusion 360插件
在Fusion 360的插件目录中创建一个名为`FusionMCP`的文件夹，然后将`FusionMCP.py`和`FusionMCP.manifest`两个文件复制到其中。
**Windows：**
```
%APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\FusionMCP\
```
**macOS：**
```
~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/FusionMCP/
```
文件夹必须命名为`FusionMCP`，并且必须包含这两个文件——如果没有清单，Fusion 360将无法识别该插件。
#### 在Fusion 360中启动插件
1. 打开Fusion 360
2. 进入**实用工具**选项卡（或**工具**，取决于您的版本）
3. 点击**插件**（或按`Shift+S`）
4. 在插件对话框中，进入**插件**选项卡
5. 点击“My Plugins”旁边的绿色**+**图标，然后浏览到`FusionMCP`文件夹
6. 选择**FusionMCP**并点击**运行**
7. 对话框将确认桥接在端口7432上运行
要使插件在启动时自动启动Fusion 360，请在插件对话框中选中**启动时运行**。
### 4. 配置Claude Desktop
打开Claude Desktop配置文件：
**Windows：** `%APPDATA%\Claude\claude_desktop_config.json`
**macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`
添加FusionMCP服务器：
```json
{
"mcpServers": {
"fusion360": {
"command": "python",
"args": ["C:/path/to/fusion-mcp/mcp_server/fusion_server.py"]
}
}
}
```
将路径替换为计算机上`fusion_server.py`的实际绝对路径。在Windows上，在路径中使用正斜杠或转义的反斜杠。
在保存配置后重启Claude Desktop。
## 使用
一切就绪后：
1. 打开Fusion 360并确保FusionMCP插件正在运行（检查启动对话框）
2. 打开Claude Desktop — 您应该看到一个锤子图标，指示MCP工具可用
3. 开始向Claude询问在Fusion 360中创建内容
### 示例提示
```
创建一个边长为10cm x 5cm x 3cm的盒子
```
```
在XY平面上绘制一个半径为2cm的圆，并将其拉伸5cm
```
```
在第一个所有边缘上添加2mm的圆角
```
```
心圆柱体：外半径3cm，壁厚0.5cm，高8cm
```
```
将当前设计以STL格式导出到桌面
```
```
创建一个类似齿轮的形状：绘制一个12边形并拉伸，然后添加一个直径为1cm的
```
### 提示
- FusionMCP中的所有使用**厘米**（360的内部单位）
-在工具参数中为**度**（在内部转换为弧度）
- 使用`get_design_info`查看当前设计内容 在针对特定面/边操作之前使用`get_face_info`或`get_edge_info `execute_script`工具aude运行任意Fusion 360 Python API代码，以处理内置工具盖的任何内容
## 故障排除
**"Fusion 360"**
-Fusion 360已打开
- 检查FusionMCP插件是否正在运行（实用工具 > 插件）
- 验证是否没有其他程序占用端口7432
**Claude Desktop未显示MCP工具**
- 验证`claude_desktop_config.json`语法是否为有效JSON
- 确保`fusion_server.py`的路径正确且绝对
- 编辑配置后重启Claude Desktop
- 检查`python`是否在您的PATH中（尝试在终端中运行`python --version`）
**插件在Fusion 360中启动失败**
- 在Fusion 360的文本命令窗口中详细信息（视图 > 文）
- 确保文件在名为`FusionMCP`的文件夹中命名为`Fusion.py`
## 许可证
MIT
