使用说明
Fusion 360 MCP服务器
注意:颜色是手动添加的
使用模型上下文协议(MCP)直接从Claude Desktop控制Fusion 360 CAD软件。
概述
该项目提供了一个MCP服务器,允许Claude在Autodesk Fusion 360中创建和操作3D CAD模型。Claude可以绘制形状,将其拉伸成3D对象,并应用圆角和倒角等特征——所有这些都是通过自然语言完成的。
建筑
Claude Desktop
| (MCP over stdio)
server.py (MCP Server)
| (HTTP/JSON on localhost:8080)
fusion_http_server.py (Fusion 360 Script)
| (Fusion 360 Python API)
Fusion 360 CAD Software
先决条件
设置
1.克隆存储库
git clone https://github.com/KevinZhao-07/Fusion-Mcp-Server.git
cd Fusion-Mcp-Server
2.安装Python依赖项
pip install mcp httpx
3.安装Fusion 360 HTTP服务器脚本
- Open Fusion 360
- 首选 公用事业 → 脚本和插件 (或按Shift+S)
- 点击 + 按钮,然后转到“从设备编写脚本或加载项”
- 引导到
Scripts/fusion_http_server/ - 脚本现在应该出现在列表中
4.配置克劳德桌面
将此添加到您的Claude Desktop MCP配置文件中:
窗户: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"fusion-cad": {
"command": "python",
"args": [
"C:/Users/YOUR_USERNAME/Desktop/Fusion-Mcp-Project/server.py"
]
}
}
}
替换 YOUR_USERNAME 使用您的实际用户名,或使用克隆仓库的完整路径。
运行说明
第一步:启动Fusion 360
打开Fusion 360并创建新设计(文件→ 新设计)。
步骤2:运行Fusion HTTP服务器
- 在Fusion 360中,转到 公用事业 → 脚本和插件 (或按Shift+S)
- 选择
fusion_http_server在“我的脚本”下 - 点击 跑
- 您应该看到:
Fusion HTTP Server started on port 8080!
继续运行 -不要关闭脚本对话框。
步骤3:启动克劳德桌面
- 启动克劳德桌面
- MCP服务器(
server.py)将自动启动 - 在Claude中查找锤子图标,以确认MCP工具已加载
快速入门示例
一切运行完毕后,在Claude Desktop中尝试以下操作:
创建一个10x10厘米的矩形,将其拉伸5厘米,并在所有边上添加1厘米的圆角。
克劳德将:
- 创建矩形草图(10 cm x 10 cm)
- 拉伸它以创建一个3D框(5厘米高)
- 用半径为1厘米的圆角将所有边缘磨圆
您将在Fusion 360中实时看到该框!
更多示例
创建圆柱体:
绘制一个半径为3厘米的圆,并将其拉伸10厘米。
创建倒角框:
制作一个5x5厘米的矩形,挤出3厘米,然后将所有边缘倒角0.5厘米。
挖一个洞:
绘制一个半径为2厘米的圆,然后使用距离为10厘米的拉伸切割。
可用工具
| 工具 | 说明 |
|---|---|
sketch_rectangle |
在XZ平面上创建矩形 |
sketch_line |
在XZ平面上绘制一条线 |
sketch_circle |
创建一个圆(按半径或直径) |
extrude_profile |
将草图拉伸到三维实体中 |
extrude_cut |
切断现有机构 |
fillet_edges |
将最后一个物体的所有边缘磨圆 |
chamfer_edges |
将最后一个主体的所有边缘斜切 |
clear_all |
清空整个工作区 |
故障排除
“无法连接到Fusion服务器”
- 确保Fusion 360正在运行
- 验证HTTP服务器脚本是否正在运行(上述步骤2)
- 检查您是否看到“Fusion HTTP服务器已在端口8080上启动!”
工具未显示在Claude Desktop中
- 验证您的
claude_desktop_config.json路径正确 - 编辑配置后重新启动Claude Desktop
- 检查Claude Desktop设置中的MCP日志
脚本无法在Fusion中运行
- 确保您添加了脚本文件夹,而不仅仅是
.py文件 - 文件夹必须同时包含这两个内容
fusion_http_server.py和fusion_http_server.manifest
“挤压失败”
- 你先画了草图吗?拉伸需要草图轮廓
- 检查草图是否创建了闭合轮廓(矩形和圆形有效,单线无效)
项目结构
Fusion-Mcp-Project/
├── server.py # MCP server (communicates with Claude Desktop)
├── README.md # This file
├── Notes.md # Design decisions and tradeoffs
└── Scripts/
└── fusion_http_server/
└── fusion_http_server.py # Fusion 360 HTTP server script
