Skip to main content
Glama
Fusion360 MCP Server

Fusion360 MCP Server

by forgemorrow

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: Fusion MCP para Codex

前置条件

  • 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

Available Tools

85 tools
add_constraintAdd Sketch ConstraintB

Add a geometric constraint in the active sketch. Entities are referenced by index within the sketch.

Inputs: constraint_type (required), entity_one, entity_two, sketch_name, +1 more.

add_dimensionAdd Sketch DimensionB

Add a driving dimension to constrain sketch geometry. Value is in cm for distances, degrees for angles.

Inputs: value (required), dimension_type (required), entity_one, entity_two, +1 more.

add_jointAdd JointB

Add a joint between two components

Inputs: component_one (required), component_two (required), joint_type.

boolean_operationBoolean OperationB

Combine two named bodies (join/cut/intersect)

Inputs: tool_body (required), target_body (required), operation.

cam_create_operationCreate CAM OperationB

Add a machining operation to a setup. Strategy determines the toolpath type.

Inputs: strategy (required), setup_name (required), name, coolant, +6 more.

cam_create_setupCreate CAM SetupB

Create a manufacturing setup for a body. Defines the stock, coordinate system, and operation type (milling/turning/cutting).

Inputs: body_name (required), name, stock_mode, operation_type, +3 more.

cam_generate_toolpathGenerate ToolpathB

Generate toolpaths for a specific operation or all operations in a setup

Inputs: setup_name, generate_all, operation_name.

cam_get_operation_infoGet CAM Operation InfoB
Read-onlyIdempotent

Get details about a specific operation (strategy, tool, parameters, toolpath status)

Inputs: setup_name (required), operation_name (required).

cam_list_operationsList CAM OperationsA
Read-onlyIdempotent

List operations within a setup

Inputs: setup_name (required).

cam_list_setupsList CAM SetupsB
Read-onlyIdempotent

List all manufacturing setups in the document

Inputs: no named parameters.

cam_post_processPost ProcessB

Post-process toolpaths to generate NC code (G-code)

Inputs: setup_name (required), output_units, output_folder, operation_name, +1 more.

chamferChamfer EdgesC

Chamfer edges of a body

Inputs: distance (required), body_name, body_index, edge_selection.

check_interferenceCheck InterferenceB
Read-onlyIdempotent

Detect collisions between components/bodies

Inputs: component_names (required), include_coincident_faces.

circular_patternCircular PatternC

Pattern a body around an axis

Inputs: count (required), body_name (required), axis, total_angle.

create_as_built_jointCreate As-Built JointC

Create a joint from components' current positions (easier than geometric joints)

Inputs: joint_type (required), component_one (required), component_two (required).

create_bendCreate BendB

Add a bend to a sheet metal body

Inputs: body_name (required), angle, bend_radius, bend_line_sketch.

create_boxCreate BoxC

Create a box primitive (non-parametric via TemporaryBRepManager)

Inputs: width (required), height (required), length (required), center_x, +2 more.

create_componentCreate ComponentB

Create a new component (sub-assembly) in the design

Inputs: name (required), parent_name.

create_construction_axisCreate Construction AxisC

Create a construction axis

Inputs: method (required), body_name, plane_one, plane_two, +3 more.

create_construction_planeCreate Construction PlaneB

Create a construction plane for sketching

Inputs: method (required), angle, plane, offset, +6 more.

create_cylinderCreate CylinderC

Create a cylinder primitive (non-parametric via TemporaryBRepManager)

Inputs: height (required), radius (required), axis, base_x, +2 more.

create_flangeCreate FlangeA

Create a sheet metal flange on an edge

Inputs: body_name (required), edge_index (required), angle, height, +1 more.

create_holeCreate HoleB

Create a hole feature on a body face

Inputs: depth (required), diameter (required), center_x, center_y, +3 more.

create_parameterCreate ParameterB

Create a new user parameter

Inputs: name (required), unit (required), value (required), comment.

create_polygonCreate PolygonB

Draw a regular polygon in the most recent sketch

Inputs: sides (required), radius (required), center_x, center_y, +1 more.

create_rigid_groupCreate Rigid GroupB

Lock multiple components together

Inputs: component_names (required), include_children.

create_section_analysisCreate Section AnalysisB

Cut a section plane through the model

Inputs: plane, offset.

create_sketchCreate SketchB

Create a new sketch on xy/yz/xz plane, optionally offset

Inputs: plane, z_offset.

create_sphereCreate SphereB

Create a sphere primitive (non-parametric via TemporaryBRepManager)

Inputs: radius (required), center_x, center_y, center_z.

create_threadCreate ThreadA

Add threads to a cylindrical face (cosmetic or modeled)

Inputs: body_name (required), face_index (required), is_modeled, is_internal, +5 more.

create_torusCreate TorusB

Create a torus primitive (non-parametric via TemporaryBRepManager)

Inputs: major_radius (required), minor_radius (required), axis, center_x, +2 more.

delete_allDelete AllA
Destructive

Clear the design (delete all timeline items)

Inputs: no named parameters.

delete_parameterDelete ParameterB
Destructive

Remove a user parameter

Inputs: name (required).

draft_facesDraft / Taper FacesB

Add a draft angle to faces of a body (for mold release / injection molding)

Inputs: angle (required), body_name (required), face_selection, is_tangent_chain, +1 more.

draw_arcDraw ArcB

Draw an arc in the most recent sketch (center + start point + sweep angle)

Inputs: start_x (required), start_y (required), center_x (required), center_y (required), +3 more.

draw_circleDraw CircleB

Draw a circle in the most recent sketch

Inputs: radius (required), center_x, center_y, center_z.

draw_lineDraw LineB

Draw a line in the most recent sketch

Inputs: end_x (required), end_y (required), start_x (required), start_y (required), +2 more.

draw_rectangleDraw RectangleA

Draw a rectangle in the most recent sketch

Inputs: width (required), height (required), origin_x, origin_y, +1 more.

draw_splineDraw SplineA

Draw a spline in the most recent sketch. Use fit_points for a curve through points, or control_points for a control-polygon spline.

Inputs: points (required), spline_type (required), degree.

execute_codeExecute CodeA

Run arbitrary Python in Fusion 360. The last expression's value is returned (REPL-style). Pre-defined names: app, ui, design, component, adsk, math.

Inputs: code (required).

export_f3dExport F3DA

Export the design as a native Fusion 360 archive (.f3d)

Inputs: file_path.

export_stepExport STEPB

Export a body or component as a STEP file

Inputs: body_name (required), file_path.

export_stlExport STLB

Export a named body as an STL file

Inputs: body_name (required), file_path.

export_view_sheetExport View SheetA

Render canonical orthographic + isometric views as PNGs and emit a self-contained HTML sheet suitable for sharing with a mechanical engineer. Opens in any browser; Print -> Save as PDF for a static artifact. Restores the viewport camera after rendering.

Inputs: notes, title, views, image_size, +1 more.

extend_curveExtend CurveA

Extend a sketch curve to the nearest intersection. The end nearest to the given point is extended.

Inputs: point_x (required), point_y (required), curve_index (required), sketch_name.

extrudeExtrudeC

Extrude a sketch profile

Inputs: height (required), direction, operation, profile_index.

filletFillet EdgesB

Round edges of a body

Inputs: radius (required), body_name, body_index, edge_selection.

flat_patternFlat PatternB

Create a flat pattern from a sheet metal body

Inputs: body_name (required).

get_design_typeGet Design TypeA
Read-onlyIdempotent

Check if the design is in parametric or direct mode. Use this to detect accidental mode switches.

Inputs: no named parameters.

get_object_infoGet Object InfoB
Read-onlyIdempotent

Get detailed info about a named body or sketch

Inputs: name (required).

get_parametersGet ParametersB
Read-onlyIdempotent

List all user parameters in the design

Inputs: no named parameters.

get_physical_propertiesGet Physical PropertiesB
Read-onlyIdempotent

Get mass, volume, surface area, center of mass, and density of a body

Inputs: body_name (required), accuracy.

get_scene_infoGet Scene InfoB
Read-onlyIdempotent

Get design name, bodies, sketches, features, camera info

Inputs: no named parameters.

list_componentsList ComponentsB
Read-onlyIdempotent

List all components in the design

Inputs: no named parameters.

loftLoftB

Loft between two or more sketch profiles

Inputs: profile_sketch_names (required), operation.

measure_angleMeasure AngleB
Read-onlyIdempotent

Measure angle between two entities

Inputs: entity_one (required), entity_two (required).

measure_distanceMeasure DistanceB
Read-onlyIdempotent

Measure minimum distance between two entities

Inputs: entity_one (required), entity_two (required).

mirrorMirror BodyB

Mirror a body across a construction plane

Inputs: mirror_plane (required), body_name, body_index.

move_bodyMove BodyB

Translate a named body by (x, y, z)

Inputs: body_name (required), x, y, z.

offset_curveOffset CurveB

Offset connected sketch curves by a distance. Direction is determined by the direction_point.

Inputs: curve_index (required), offset_distance (required), direction_x, direction_y, +1 more.

offset_facesOffset FacesB

Push/pull faces of a body by a distance

Inputs: distance (required), body_name (required), face_indices, face_selection.

patch_surfacePatch SurfaceB

Create a patch surface from boundary edges

Inputs: sketch_name (required), continuity, profile_index.

pingPingA
Read-onlyIdempotent

Health check — returns immediately without touching Fusion API

Inputs: no named parameters.

project_geometryProject GeometryB

Project edges or bodies onto the active sketch plane

Inputs: source_name (required), is_linked, sketch_name.

rectangular_patternRectangular PatternB

Pattern a body in rows and columns

Inputs: body_name (required), x_count, y_count, x_spacing, +1 more.

rename_bodyRename BodyA
Idempotent

Rename a body (searches root and all components)

Inputs: new_name (required), body_name (required).

render_viewRender ViewportA
Read-onlyIdempotent

Capture the active viewport as a PNG so you can visually verify the model. Pass a canonical view (iso/front/top/etc.) to reposition the camera first, or 'current' to keep it as is. Returns base64-encoded image bytes alongside metadata; the MCP server delivers it as an image content block.

Inputs: fit, view, width, height.

revolveRevolveB

Revolve a sketch profile around an axis

Inputs: angle (required), operation, axis_origin_x, axis_origin_y, +5 more.

ruled_surfaceRuled SurfaceB

Create a ruled surface from an edge or sketch curve

Inputs: body_name (required), edge_index (required), distance, rule_type.

scale_bodyScale BodyB

Scale a body uniformly or non-uniformly

Inputs: scale (required), body_name (required), scale_x, scale_y, +4 more.

set_appearanceSet AppearanceB
Idempotent

Assign a material appearance to a body, face, or component from the Fusion appearance library

Inputs: target_name (required), appearance_name (required), face_index, target_type.

set_design_typeSet Design TypeA
Idempotent

Switch design type between 'parametric' and 'direct'. Use 'parametric' to recover from accidental direct-mode switches (equivalent to Capture Design History in the UI).

Inputs: design_type (required).

set_parameterSet ParameterB
Idempotent

Update the value of an existing user parameter

Inputs: name (required), value (required).

shellShell BodyB

Hollow out a body by removing a face

Inputs: thickness (required), body_name, body_index, face_selection.

split_bodySplit BodyB

Split a body using a plane or face

Inputs: body_name (required), extend_tool, splitting_body, splitting_plane.

split_faceSplit FaceB

Split faces of a body using a plane

Inputs: body_name (required), extend_tool, face_indices, splitting_plane.

stitch_surfacesStitch SurfacesB

Stitch surface bodies into a single body

Inputs: body_names (required), tolerance.

suppress_featureSuppress FeatureB

Suppress (disable) a feature in the timeline

Inputs: feature_name (required).

sweepSweepB

Sweep a sketch profile along a path (sketch curve)

Inputs: profile_index (required), path_sketch_name (required), operation, path_curve_index.

thicken_surfaceThicken SurfaceB

Thicken a surface body into a solid

Inputs: body_name (required), thickness (required), direction.

trim_curveTrim CurveA

Trim a sketch curve at its intersections. The segment nearest to the given point is removed.

Inputs: point_x (required), point_y (required), curve_index (required), sketch_name.

trim_surfaceTrim SurfaceB

Trim a surface body with another body

Inputs: body_name (required), tool_name (required).

undoUndoB

Undo the last operation

Inputs: no named parameters.

unfoldUnfoldB

Unfold specific bends in a sheet metal body

Inputs: body_name (required), bend_indices.

unsuppress_featureUnsuppress FeatureB

Unsuppress (re-enable) a feature in the timeline

Inputs: feature_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 85 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (e.g., extrude vs revolve vs loft), but several CAM tools (cam_generate_toolpath, cam_post_process, cam_create_operation) and some feature tools (split_body vs split_face, create_bend vs create_flange) have subtle overlaps that could cause confusion without domain knowledge.

    Naming Consistency4/5

    The vast majority of tools follow a consistent snake_case verb_noun pattern. A few naming quirks exist (e.g., 'extrude' and 'fillet' as bare verbs, and the 'cam_' prefix for CAM tools), but these are minor deviations and not misleading.

    Tool Count1/5

    85 tools is excessive for a single MCP server, far exceeding the typical 3-15 range. While Fusion 360 is a broad domain, this count suggests poor scoping and will impose significant cognitive load on an agent.

    Completeness5/5

    The tool set covers an impressively complete range of Fusion 360 workflows: sketching, solid modeling, surface modeling, sheet metal, CAM, assemblies, parameters, measurement, rendering, and export. CRUD operations for parameters and components are present, and the domain coverage is comprehensive.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      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.
      4
      80
      512 PyPI
      152
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to inspect and automate Autodesk Fusion 360 through MCP, providing tools for CAD modeling, CAM manufacturing, and document management.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that gives AI agents genuine 3D spatial understanding of Autodesk Fusion 360, enabling exact measurements, collision analysis, and free-space placement search, plus Fusion-native parametric authoring for clean, human-editable models.
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables MCP-compatible assistants to control Autodesk Fusion for mechanical modeling, assembly editing, CAM workflows, inspection, and model export through Fusion's native MCP endpoint.
      39
      1
      MIT