AI导哈

自然语言控制Fusion 360

FusionMCP是一个通过自然语言控制Autodesk Fusion 360的MCP服务器，提供草图绘制、3D建模、装配、导出等功能。

  • by imranduratbegovic
  • Python
  • 本地部署
  • 53 星标
  • 更新于
在 GitHub 查看 Anonimus124/fusion-mcp

使用说明

FusionMCP

通过Claude用自然语言控制Autodesk Fusion 360。FusionMCP是一个 MCP（模型上下文协议） 该服务器使Claude可以直接访问Fusion 360的CAD引擎——草图绘制、建模、装配、导出等。

运作原理

Claude Desktop  ──stdio──▶  MCP Server (Python)  ──HTTP──▶  Fusion 360 Add-in
                             fusion_server.py                 FusionMCP.py
                             (your machine)                   (inside Fusion 360)
  1. MCP服务器 (mcp_server/fusion_server.py)--在本地运行，并通过stdio上的模型上下文协议向Claude公开工具。
  2. Fusion 360插件 (FusionMCP.py)--在Fusion 360内运行，收听 http://127.0.0.1:7432，接收来自MCP服务器的命令，并使用Fusion 360 Python API在Fusion的主线程上执行这些命令。

特性

素描

  • 图元：矩形、中心矩形、圆、直线、圆弧、多边形、椭圆、样条曲线、槽、文本
  • 操作：圆角、偏移、镜像、矩形图案
  • 约束：重合、相切、垂直、平行、水平、垂直、同心、相等、中点、固定、共线、平滑
  • 尺寸：距离、角度、直径、半径

三维建模

  • 拉伸、旋转、放样、扫掠、螺旋、管道
  • 壳体、圆角、倒角、拔模斜度、螺纹
  • 按压/拉动面，加厚草图
  • 布尔运算（连接、剪切、相交）
  • 移动、旋转、缩放（均匀和非均匀）、复制、镜像
  • 矩形和圆形车身图案
  • 孔特征（简单、沉孔、埋头孔）

装配

  • 创建组件，在组件之间移动实体
  • 接头：刚性、旋转、滑块、圆柱形、销槽、平面、球形
  • 竣工接缝

检查

  • 设计信息（组件、草图、实体、参数、关节）
  • 目标操作的面部/边缘/草图信息
  • 身体测量（边界框、体积、面/边/顶点计数）
  • 实体之间的距离测量
  • 功能时间线

参数和外观

  • 创建和更新用户参数
  • 应用Fusion库中的材质外观
  • 在车身上设置自定义RGB颜色

导出和捕获

  • STL、STEP、3MF、F3D（融合档案）
  • 视口截图

其他

  • 在Fusion 360中执行任意Python脚本
  • 创建/清除文档
  • 撤销/重做
  • 保存/另存为

先决条件

安装

1.克隆存储库

git clone https://github.com/Anonimus124/fusion-mcp.git
cd fusion-mcp

2.安装Python依赖项

pip install -r mcp_server/requirements.txt

这将安装：

  • mcp --模型上下文协议SDK
  • requests --用于与Fusion加载项通信的HTTP客户端

3.安装Fusion 360附加模块

创建一个名为的文件夹 FusionMCP 在Fusion 360的插件目录中，然后复制 两者 FusionMCP.py 和 FusionMCP.manifest 进入它。

窗户：

%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. Open Fusion 360
  2. 去 公用事业 选项卡（或 工具 取决于您的版本）
  3. 点击 加载项 （或按 Shift+S)
  4. 在“附加模块”对话框中，转到 加载项 标签
  5. 点击绿色 + “我的加载项”旁边的图标，然后浏览到 FusionMCP 文件夹
  6. 选择 FusionMCP 然后单击 跑
  7. 对话框将确认网桥正在端口7432上运行

要使用Fusion 360自动启动附加模块，请检查 启动时运行 在“附加模块”对话框中。

4.配置克劳德桌面

打开您的Claude Desktop配置文件：

窗户： %APPDATA%\Claude\claude_desktop_config.json

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

添加FusionMCP服务器：

{
  "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. 打开克劳德桌面——你应该看到一个锤子图标，表明MCP工具可用
  3. 开始让克劳德在Fusion 360中创建东西

示例提示

Create a box that's 10cm x 5cm x 3cm

Draw a circle with radius 2cm on the XY plane and extrude it 5cm

Add 2mm fillets to all edges of the first body

Create a hollow cylinder: outer radius 3cm, wall thickness 0.5cm, height 8cm

Export the current design as STL to my desktop

Create a gear-like shape: draw a 12-sided polygon and extrude it, then add
a center hole with diameter 1cm

提示

  • FusionMCP使用的所有尺寸 厘米 （Fusion 360的内部单元）
  • 角度在 度 刀具参数（内部转换为弧度）
  • 使用 get_design_info 查看当前设计中的内容
  • 使用 get_face_info 或 get_edge_info 在针对特定面/边的操作之前
  • 这 execute_script 该工具允许Claude为内置工具未涵盖的任何内容运行任意Fusion360Pythonneneneba API代码

故障排除

“无法访问Fusion 360”

  • 确保Fusion 360已打开
  • 检查FusionMCP加载项是否正在运行（实用程序>加载项）
  • 验证端口7432上没有其他东西

Claude Desktop未显示MCP工具

  • 验证您的 claude_desktop_config.json 语法是有效的JSON
  • 确保路径 fusion_server.py 是正确和绝对的
  • 编辑配置后重新启动Claude Desktop
  • 检查一下 python 在你的路径中（试试 python --version 在终端中）

Fusion 360中的加载项无法启动

  • 检查Fusion 360文本命令窗口以了解错误详细信息（查看>文本命令）
  • 确保文件已命名 FusionMCP.py 在名为的文件夹中 FusionMCP

许可证

麻省理工学院

相关 MCP