CAD控制服务器

通过Model Context Protocol (MCP)控制Fusion 360 CAD软件,实现自然语言创建和操作3D模型。

  • by KevinZhao-07
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 KevinZhao-07/Fusion-Mcp-Server

使用说明

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服务器脚本

  1. Open Fusion 360
  2. 首选 公用事业 → 脚本和插件 (或按Shift+S)
  3. 点击 + 按钮,然后转到“从设备编写脚本或加载项”
  4. 引导到 Scripts/fusion_http_server/
  5. 脚本现在应该出现在列表中

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服务器

  1. 在Fusion 360中,转到 公用事业 → 脚本和插件 (或按Shift+S)
  2. 选择 fusion_http_server 在“我的脚本”下
  3. 点击 跑
  4. 您应该看到: Fusion HTTP Server started on port 8080!

继续运行 -不要关闭脚本对话框。

步骤3:启动克劳德桌面

  1. 启动克劳德桌面
  2. MCP服务器(server.py)将自动启动
  3. 在Claude中查找锤子图标,以确认MCP工具已加载

快速入门示例

一切运行完毕后,在Claude Desktop中尝试以下操作:

创建一个10x10厘米的矩形,将其拉伸5厘米,并在所有边上添加1厘米的圆角。

克劳德将:

  1. 创建矩形草图(10 cm x 10 cm)
  2. 拉伸它以创建一个3D框(5厘米高)
  3. 用半径为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