VOOZH about

URL: https://glama.ai/mcp/servers/faust-machines/fusion360-mcp-server?locale=zh-CN

⇱ Fusion360 MCP 服务器 by faust-machines | Glama

Fusion360 MCP 服务器

Beta — 该项目处于活跃开发阶段。API 和工具行为可能会在版本更新中发生变化。请自行斟酌使用。欢迎通过 GitHub Issues 提供反馈和报告错误。

用于将 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 服务器（本仓库）— 与 Claude 进行 MCP 协议通信并通过 TCP 转发命令的 Python 进程

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

Related MCP server: Fusion360 LLM Assistant

前置要求

  • 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 → Run

你应该会在 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

使用平面分割实体

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

偏移、角度、中平面、3点、相切

create_construction_axis

两点、交点、边、垂直

装配

工具

描述

create_component

创建子装配组件

add_joint

在两个组件之间添加关节

create_as_built_joint

从当前位置创建关节

create_rigid_group

将组件锁定在一起

检查与分析

工具

描述

measure_distance

实体间的最小距离

measure_angle

实体间的角度

get_physical_properties

质量、体积、面积、质心

create_section_analysis

模型的剖面分析

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

列出所有制造设置

cam_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

  • 模拟模式 — --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 — 套接字桥接架构源于此。

同时也建立在现有 Fusion 360 MCP 生态系统的理念之上：

许可证

MIT

A
license - permissive license
B
quality
D
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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/faust-machines/fusion360-mcp-server'

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