Fusion360 MCP Server
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两个组件:
MCP 服务器(本仓库)— Python 进程,负责与 Claude 通信 MCP 协议并通过 TCP 转发命令
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},说明一切已连接。
卸载
从你的 MCP 客户端配置中移除
fusion360条目在 Fusion 中停止插件(Shift+S → Add-Ins → Fusion360MCP → Stop)
将插件文件夹从 Fusion 的 AddIns 目录中删除
可用工具(84 个)
场景与查询
工具 | 说明 |
| 健康检查(即时,无需 Fusion API) |
| 设计名称、实体、草图、特征、视角 |
| 指定实体或草图的详细信息 |
| 列出设计中的所有组件 |
设计类型安全
工具 | 说明 |
| 检查设计处于参数化还是直接模式 |
| 切换设计类型(参数化/直接恢复) |
草图
工具 | 说明 |
| 在 xy/yz/xz 平面上新建草图,可指定偏移 |
| 在最近的草图中绘制矩形 |
| 在最近的草图中绘制圆 |
| 在最近的草图中绘制直线 |
| 圆弧(圆心 + 起点 + 扫掠角) |
| 拟合成点或控制点样条曲线 |
| 正多边形(3–64 条边) |
| 几何约束(重合、平行、相切等) |
| 驱动尺寸(距离、角度、径向、直径) |
| 偏移相连的曲线 |
| 在交点处修剪 |
| 延伸到最近交点 |
| 将边/实体投影到草草图 |
特征
工具 | 说明 |
| 拉伸草图轮廓 |
| 绕轴旋转轮廓 |
| 沿路径扫掠轮廓 |
| 在两个或多个轮廓之间放样 |
| 边倒角(全部/顶部/底部/垂直) |
| 边倒斜角 |
| 将实体壳体化(掏空) |
| 沿平面镜像实体 |
| 在实体面上创建孔特征 |
| 按行和列创建阵列 |
| 绕轴圆形阵列 |
| 添加螺纹(装饰性或建模) |
| 为脱模添加拔模/锥面 |
| 使用平面分割实体 — 保持原提示 |
| 分割实体 |
| 按设置移动/拉开面 |
| 均匀或非均匀缩放实体 |
| 抑制时间轴特征 |
| 重新启用已抑制的特征 |
实体操作
工具 | 说明 |
| 按 (x, y, z) 平移实体 |
| 重命名实体(搜索根和所有组件) |
| 合并/成载荷/求交两个实体 |
| 清空设计 |
| 撤销上一次操作(内置设计类型安全检查) |
直接图元
工具 | 说明 |
| 长方体(通过 TemporaryBRepManager) |
| 圆柱体 |
| 球体 |
| 圆环体 |
曲面操作
工具 | 说明 |
| 从边界边创建补片曲面 |
| 将多个曲面实体缝合为一个 |
| 将曲面加厚为实体 |
| 从一条边创建直纹曲面 |
| 用另一个实体修剪曲面 |
钣金
工具 | 说明 |
| 在边上创建法兰 |
| 添加折办 |
| 创建平面展开图 |
| 展开指定的折弯 |
构造几何
工具 | 说明 |
| 等距、角度、中平面、三点、相切 |
| 两点、交点、边、垂直 |
装配
工具 | 说明 |
| 创建子装配组件 |
| 在两个组件之间增加装配 |
| 从当前位置创建装配 |
| 将组件刚性地锁在一起 |
检查与分析
工具 | 说明 |
| 计算实体之间的最小距离 |
| 计算实体之间的角度 |
| 质量、体积、面积、重心 |
| 沿模型截面创建剖切平面 |
| 检测组件之间干涉 |
外观
工具 | 说明 |
| 从材质库指定材质外观 |
参数
工具 | 说明 |
| 列出所有用户参数 |
| 创建新参数 |
| 更新参数值 |
| 删除参数 |
导出
工具 | 说明 |
| 将实体导出为 STL(支持组件内部的实体) |
| 将实体导出为 STEP(支持组件内部的实体) |
| 将设计导出为 Fusion 设计文件 |
CAM / 制造
工具 | 说明 |
| 创建制造设置(铣削/车削/切割) |
| 添加加工操作(面、轮廓、自适应、钻孔等) |
| 为操作生成刀具路径 |
| 后处理为 G 代码(fanuc、grbl、haas 等) |
| 列出所有制造设置 |
| 列出设置中的操作 |
| 获取操作详情(加工策略、刀具、参数) |
代码执行
工具 | 说明 |
| 在 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 toolsadd_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 InfoBRead-onlyIdempotent
Get details about a specific operation (strategy, tool, parameters, toolpath status)
Inputs: setup_name (required), operation_name (required).
cam_list_operationsList CAM OperationsARead-onlyIdempotent
List operations within a setup
Inputs: setup_name (required).
cam_list_setupsList CAM SetupsBRead-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 InterferenceBRead-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 AllADestructive
Clear the design (delete all timeline items)
Inputs: no named parameters.
delete_parameterDelete ParameterBDestructive
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 TypeARead-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 InfoBRead-onlyIdempotent
Get detailed info about a named body or sketch
Inputs: name (required).
get_parametersGet ParametersBRead-onlyIdempotent
List all user parameters in the design
Inputs: no named parameters.
get_physical_propertiesGet Physical PropertiesBRead-onlyIdempotent
Get mass, volume, surface area, center of mass, and density of a body
Inputs: body_name (required), accuracy.
get_scene_infoGet Scene InfoBRead-onlyIdempotent
Get design name, bodies, sketches, features, camera info
Inputs: no named parameters.
list_componentsList ComponentsBRead-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 AngleBRead-onlyIdempotent
Measure angle between two entities
Inputs: entity_one (required), entity_two (required).
measure_distanceMeasure DistanceBRead-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.
pingPingARead-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 BodyAIdempotent
Rename a body (searches root and all components)
Inputs: new_name (required), body_name (required).
render_viewRender ViewportARead-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 AppearanceBIdempotent
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 TypeAIdempotent
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 ParameterBIdempotent
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
Scored across 85 tools
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.
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.
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.
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
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Related MCP Servers
- AlicenseBqualityCmaintenanceConnects 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.480512 PyPI152MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to inspect and automate Autodesk Fusion 360 through MCP, providing tools for CAD modeling, CAM manufacturing, and document management.-
- AlicenseNot gradedqualityDmaintenanceAn 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
- AlicenseCqualityCmaintenanceEnables MCP-compatible assistants to control Autodesk Fusion for mechanical modeling, assembly editing, CAM workflows, inspection, and model export through Fusion's native MCP endpoint.391MIT