Skip to main content
Glama
deenesjakoruzh
shiguangzhe666

Fusion360 MCP Server

by shiguangzhe666
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Fusion360 MCP Server

Beta — 此项目正在积极开发中。API 和工具行为在版本之间可能会发生变化。请自行斟酌使用。欢迎通过 GitHub Issues 提交反馈和 bug 报告。

将 AI 编程助手连接到 Autodesk Fusion 360 以实现 CAD 自动化的 MCP 服务器。

已通过 Claude Code 测试。可与任何兼容 MCP 的客户端配合使用 — OpenCode、Codex、Cursor，或任何支持 Model Context Protocol 的客户端。

工作原理

Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread

两个组件：

  1. MCP 服务器（本仓库）— Python 进程，负责与 Claude 通信 MCP 协议并通过 TCP 转发命令

  2. Fusion360MCP 插件（安装在 Fusion 的 AddIns 文件夹中）— 在 Fusion 360 内部运行，在主线程上安全执行 API 调用

Related MCP server: Fusion360 MCP Server

前置条件

  • uv（Python 包管理器）

  • Autodesk Fusion 360

  • 支持 MCP 的客户端（Claude Code、OpenCode、Codex、Cursor 等）

安装

1. 安装 Fusion 360 插件

快速安装（用于开发的符号链接）：

./scripts/install-addon.sh

手动安装：

# macOS
cp -r addon ~/Library/Application\ Support/Autodesk/Autodesk\ Fusion\ 360/API/AddIns/Fusion360MCP

# Windows (PowerShell)
Copy-Item -Recurse addon "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

然后在 Fusion 中启动它：Shift+S → Add-Ins → Fusion360MCP → 运行

你应该在 TEXT COMMANDS 窗口中看到 [MCP] Server listening on localhost:9876。

2. 连接你的 MCP 客户端

MCP 服务器已发布到 PyPI — 无需克隆此仓库。

Claude Code

claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

其他 MCP 客户端

服务器通过 stdio 运行，因此任何支持 MCP 的客户端都可以启动它。命令为：

uvx fusion360-mcp-server --mode socket
{
  "mcpServers": {
    "fusion360": {
      "command": "uvx",
      "args": [
        "fusion360-mcp-server",
        "--mode", "socket"
      ]
    }
  }
}

3. 验证

从你的客户端调用 ping 工具。如果返回 {"pong": true}，说明一切已连接。

卸载

  1. 从你的 MCP 客户端配置中移除 fusion360 条目

  2. 在 Fusion 中停止插件（Shift+S → Add-Ins → Fusion360MCP → Stop）

  3. 将插件文件夹从 Fusion 的 AddIns 目录中删除

可用工具（84 个）

场景与查询

工具

说明

ping

健康检查（即时，无需 Fusion API）

get_scene_info

设计名称、实体、草图、特征、视角

get_object_info

指定实体或草图的详细信息

list_components

列出设计中的所有组件

设计类型安全

工具

说明

get_design_type

检查设计处于参数化还是直接模式

set_design_type

切换设计类型（参数化/直接恢复）

草图

工具

说明

create_sketch

在 xy/yz/xz 平面上新建草图，可指定偏移

draw_rectangle

在最近的草图中绘制矩形

draw_circle

在最近的草图中绘制圆

draw_line

在最近的草图中绘制直线

draw_arc

圆弧（圆心 + 起点 + 扫掠角）

draw_spline

拟合成点或控制点样条曲线

create_polygon

正多边形（3–64 条边）

add_constraint

几何约束（重合、平行、相切等）

add_dimension

驱动尺寸（距离、角度、径向、直径）

offset_curve

偏移相连的曲线

trim_curve

在交点处修剪

extend_curve

延伸到最近交点

project_geometry

将边/实体投影到草草图

特征

工具

说明

extrude

拉伸草图轮廓

revolve

绕轴旋转轮廓

sweep

沿路径扫掠轮廓

loft

在两个或多个轮廓之间放样

fillet

边倒角（全部/顶部/底部/垂直）

chamfer

边倒斜角

shell

将实体壳体化（掏空）

mirror

沿平面镜像实体

create_hole

在实体面上创建孔特征

rectangular_pattern

按行和列创建阵列

circular_pattern

绕轴圆形阵列

create_thread

添加螺纹（装饰性或建模）

draft_faces

为脱模添加拔模/锥面

split_body_plane

使用平面分割实体 — 保持原提示

split_face

分割实体

offset_faces

按设置移动/拉开面

scale_body

均匀或非均匀缩放实体

suppress_feature

抑制时间轴特征

unsuppress_feature

重新启用已抑制的特征

实体操作

工具

说明

move_body

按 (x, y, z) 平移实体

rename_body

重命名实体（搜索根和所有组件）

boolean_operation

合并/成载荷/求交两个实体

delete_all

清空设计

undo

撤销上一次操作（内置设计类型安全检查）

直接图元

工具

说明

create_box

长方体（通过 TemporaryBRepManager）

create_cylinder

圆柱体

create_sphere

球体

create_torus

圆环体

曲面操作

工具

说明

patch_surface

从边界边创建补片曲面

stitch_surfaces

将多个曲面实体缝合为一个

thicken_surface

将曲面加厚为实体

ruled_surface

从一条边创建直纹曲面

trim_surface

用另一个实体修剪曲面

钣金

工具

说明

create_flange

在边上创建法兰

create_bend

添加折办

flat_pattern

创建平面展开图

unfold

展开指定的折弯

构造几何

工具

说明

create_construction_plane

等距、角度、中平面、三点、相切

create_construction_axis

两点、交点、边、垂直

装配

工具

说明

create_component

创建子装配组件

add_joint

在两个组件之间增加装配

create_as_built_joint

从当前位置创建装配

create_rigid_group

将组件刚性地锁在一起

检查与分析

工具

说明

measure_distance

计算实体之间的最小距离

measure_angle

计算实体之间的角度

get_physical_properties

质量、体积、面积、重心

createSectionAnalysis

沿模型截面创建剖切平面

check_interference

检测组件之间干涉

外观

工具

说明

set_appearance

从材质库指定材质外观

参数

工具

说明

get_parameters

列出所有用户参数

create_parameter

创建新参数

set_parameter

更新参数值

delete_parameter

删除参数

导出

工具

说明

export_stl

将实体导出为 STL（支持组件内部的实体）

export_step

将实体导出为 STEP（支持组件内部的实体）

export_f3d

将设计导出为 Fusion 设计文件

CAM / 制造

工具

说明

cam_create_setup

创建制造设置（铣削/车削/切割）

cam_create_operation

添加加工操作（面、轮廓、自适应、钻孔等）

cam_generate_toolpath

为操作生成刀具路径

cam_post_process

后处理为 G 代码（fanuc、grbl、haas 等）

cam_list_setups

列出所有制造设置

cmd_list_operations

列出设置中的操作

cam_get_operation_info

获取操作详情（加工策略、刀具、参数）

代码执行

工具

说明

execute_code

在 Fusion 中运行任意 Python 代码（REPL 风格）

MCP 协议特性

  • 工具注释 — 每个工具都用 readOnlyHint、destructiveHint 和 idempotentHint 标注，以便 MCP 客户端自动批准安全操作

  • 资源 — fusion360://status、fusion360://design、fusion360://parameters 用于被动查看状态

  • 资源模板 — fusion360://body/{name}、fusion360://component/{name} 用于动态实体查找

  • 提示 — create-box、model-threaded-bolt、sheet-metal-enclosure 工作流模板

  • 结构化错误 — 当插件返回失败时，工具的 "结果包含 isError=True"

  • Mock 模式 — --mode mock 在未运行 Fusion 时返回合理的测试数据（所有响应均包含 "mode": "mock"）

开发

uv sync --dev       # install deps
uv run pytest -v    # run tests (171 tests)
uv run ruff check   # lint

备注

  • 所有 Fusion API 单位均为 厘米（Fusion 的内部标准）。

  • 每次工具调用只执行一个操作。批量执行多个操作会导致插件崩溃。

  • 必须有超时，命令在 30 秒后超时。

  • 插件日志记录到 ~/fusion360mcp.log。

  • undo 工具包含数据设计类型保护 — 它执行前会检查，并在操作从参数化模式切换到直接模式前自动撤销，在检查后自动重做。

鸣谢

灵感来自 BlenderMCP — socket 桥架构最初出自该项目。

此外，还借鉴了现有 Fusion 360 MCP 社区的许多想法：

许可证

MIT

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Fusion360 LLM Assistant

    ferocknew
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language 3D modeling in Fusion 360 through an MCP server that translates user commands into Fusion 360 API calls. Supports creating, editing, and managing 3D objects, executing Python code, and capturing model views through conversational interactions.
    1
    MIT

  • Fusion360 MCP Server

    faust-machines
    A
    license
    B
    quality
    D
    maintenance
    Connects AI coding agents to Autodesk Fusion 360 for CAD automation, enabling natural language control over sketching, 3D modeling, and CAM operations. It uses a Python-based bridge and a custom add-in to execute over 80 tools ranging from simple geometry creation to complex assembly and parameter management.
    80
    77
    MIT

  • fusion-mcp

    prim-design
    A
    license
    Not graded
    quality
    D
    maintenance
    Open-source MCP server for controlling Autodesk Fusion 360 from any AI agent, enabling 3D modeling operations via natural language.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shiguangzhe666/Fusion360-MCP-AICAD'

If you have feedback or need assistance with the MCP directory API, please join our Discord server