Fusion 360 MCP服务器
通过模型上下文协议（MCP）使用Claude AI控制Autodesk Fusion 360。
这有什么作用
Fusion 360 MCP Demo *让克劳德创建一个零件，观看它在Fusion 360中的显示*
此MCP服务器允许Claude AI直接控制Fusion 360，以：
- 创建三维草图、拉伸、旋转和扫掠
- 构建具有适当定位的多组件组件
- 应用圆角、倒角、壳和图案
- 导出为STL、STEP和3MF格式
- 测量几何形状并验证设计
示例提示： *“创建一个50mm的立方体，边缘为5mm的圆角”* “克劳德直接在Fusion 360中创建了它。
______________________________________________________________________
快速入门（5分钟）
先决条件
- Autodesk Fusion 360（个人免费使用）
- 支持MCP的Claude Desktop应用程序
- Python 3.10+
pip
步骤1：安装MCP服务器
# Install the MCP framework
pip install mcp
# Clone this repository (or download ZIP)
git clone https://github.com/YOUR_USERNAME/fusion360-mcp.git
cd fusion360-mcp步骤2：安装Fusion 360插件
- Open Fusion 360
- 首选 公用事业 → 插件 （或按
Shift+S) - 点击 加载项 选项卡†' 绿色+ 按钮
- 导航到
fusion-addin此仓库中的文件夹 - 选择
FusionMCP文件夹†'点击 打开 - 检查 启动时运行 •点击 跑
您应该看到： *“Fusion MCP已启动！正在侦听：C:\\用户…\\Fusion_MCP_comm”*
Add-in Success *已成功安装FusionMCP加载项*
步骤3：配置Claude桌面
编辑您的Claude Desktop配置文件：
窗户： %APPDATA%\Claude\claude_desktop_config.json\ 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
将此添加到 mcpServers 章节：
{
"mcpServers": {
"fusion360": {
"command": "python",
"args": ["C:/path/to/fusion360-mcp/mcp-server/fusion360_mcp_server.py"]
}
}
}注： 在路径中使用正斜杠，即使在Windows上也是如此。
步骤4：添加技能文件（推荐）
为了获得最佳效果，创建一个 克劳德项目 并粘贴以下内容 docs/SKILL.md 进入 项目说明这教会了克劳德：
- Fusion 360坐标系规则
- 单位惯例（所有单位都是厘米！）
- 装配的最佳实践
- 需要避免的常见陷阱
用于高级空间推理，还包括 docs/SPATIAL_AWARENESS.md这教会了克劳德：
- 如何在操作前验证几何图形的放置
- 草图平面和世界空间之间的坐标映射
- XZ/YZ平面的临界Z否定规则
- 操作前/操作后验证协议
步骤5：重新启动并测试
- 重新启动克劳德桌面
- 打开Fusion 360（确保加载项正在运行）
- 问克劳德： *“创建一个5cm x 3cm x 2cm的简单盒子”*
______________________________________________________________________
运作原理
┌─────────────┠MCP ┌─────────────────────┠File ┌─────────────â”
│ Claude │ â†â†’ Protocol → │ MCP Server │ â†â†’ System â†â†’ │ Fusion 360 │
│ Desktop │ │ (fusion360_mcp_ │ │ Add-in │
│ │ │ server.py) │ │ (FusionMCP)│
└─────────────┘ └─────────────────────┘ └─────────────┘- Claude通过MCP协议发送命令
- MCP服务器将命令写入
~/fusion_mcp_comm/command_*.json - Fusion插件轮询命令，通过Fusion API执行命令
- 结果已写入
~/fusion_mcp_comm/response_*.json - MCP服务器将结果返回给Claude
______________________________________________________________________
可用工具
| 类别 | 工具 |
|---|---|
| 素描 | create_sketch, draw_rectangle, draw_circle, draw_line, draw_arc, draw_polygon, draw_slot, finish_sketch |
| 3D操作 | extrude, revolve, sweep, loft, shell, draft |
| 修改 | fillet, chamfer, combine, split_body |
| 模式 | pattern_rectangular, pattern_circular, mirror |
| 组件 | create_component, move_component, rotate_component, list_components |
| 导出/导入 | export_stl, export_step, export_3mf, import_mesh |
| 检查 | get_design_info, get_body_info, measure, fit_view |
| 批次 | batch_operations （多个操作速度提高5-10倍） |
看 docs/TOOL_REFERENCE.md 获取完整的API文档。
______________________________________________________________________
重要提示：单位为厘米！
âš ï¸ MCP中的所有尺寸均以厘米为单位，而不是毫米。
| 您想要 | 请输入 |
|---|---|
| 50毫米 | 5.0 |
| 100毫米 | 10.0 |
| 1英寸 | 2.54 |
这是最常见的错误来源。A值 50 意思是50厘米（半米）！
______________________________________________________________________
项目结构
fusion360-mcp/
├── README.md # This file
├── LICENSE # MIT License
├── mcp-server/
│ └── fusion360_mcp_server.py # MCP server (run by Claude Desktop)
├── fusion-addin/
│ ├── FusionMCP.py # Fusion 360 add-in code
│ └── FusionMCP.manifest # Add-in manifest
├── docs/
│ ├── SKILL.md # Claude Project instructions
│ ├── SPATIAL_AWARENESS.md # 3D coordinate system & verification
│ ├── TOOL_REFERENCE.md # Complete API reference
│ └── KNOWN_ISSUES.md # Common pitfalls and solutions
└── examples/
└── getting_started.md # Tutorial examples______________________________________________________________________
示例工作流
创建简单零件
Simple Box Creation *“创建一个边长为5cm、圆角为2mm的立方体”*
复杂装配
Assembly Example *多部件装配，定位正确*
导出就绪文件
Export Formats *直接导出为STL、STEP和3MF格式*
______________________________________________________________________
故障排除
“45秒后超时”错误
- Fusion 360未运行，或者
- FusionMCP插件未启动
- 修复： 打开Fusion 360“实用程序”“插件”“运行FusionMCP”
克劳德没有看到Fusion 360工具
- 配置中的MCP服务器路径错误
- Python找不到
mcp包裹 - 修复： 验证路径是否使用正斜杠，运行
pip install mcp
尺寸太大/太小
- 你使用的是毫米而不是厘米
- 修复： 将所有毫米值除以10
加载项无法安装
- 文件夹结构错误
- 修复： 外接程序文件夹必须同时包含这两个内容
.py和.manifest文件
______________________________________________________________________
贡献
欢迎投稿！拜托：
- 克隆该仓库
- 创建要素分支
- 提交拉取请求
______________________________________________________________________
许可证
MIT许可证-请参阅许可证文件。
______________________________________________________________________
学分
- 用Claude AI（Anthropic）开发的MCP服务器和插件
- 使用 模型上下文协议 通过Anthropic
- 专为 Autodesk Fusion 360