Fusion360 MCP Server
Fusion360 MCP Server
Beta — 이 프로젝트는 활발히 개발 중입니다. API와 도구 동작은 릴리스 사이에 변경될 수 있습니다. 사용은 본인 판단 하에 진행해 주세요. 피드백과 버그 보고는 GitHub Issues로 환영합니다.
AI 코딩 에이전트를 Autodesk Fusion 360에 연결하여 CAD 자동화를 수행하는 MCP 서버입니다.
Claude Code로 테스트되었습니다. OpenCode, Codex, Cursor 또는 Model Context Protocol을 지원하는 모든 MCP 호환 클라이언트에서 작동합니다.
작동 방식
Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread두 가지 구성 요소로 이루어져 있습니다.
MCP Server (이 저장소) — Claude와 MCP 프로토콜로 통신하고 TCP로 명령을 전달하는 Python 프로세스
Fusion360MCP Add-in (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 Add-in 설치
빠른 설치 (개발용 심볼릭 링크):
./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}가 반환되면 모든 것이 연결된 것입니다.
제거
MCP 클라이언트 설정에서
fusion360항목을 제거합니다.Fusion에서 애드인을 중지합니다 (Shift+S → Add-Ins → Fusion360MCP → Stop)
Fusion의 AddIns 디렉터리에서 애드인 폴더를 삭제합니다.
사용 가능한 도구 (84)
장면 및 조회
도구 | 설명 |
| 상태 확인 (즉시 응답, Fusion API 사용 안 함) |
| 디자인 이름, 본체, 스케치, 피처, 카메라 가져오기 |
| 지정된 본체 또는 스케치에 대한 상세 정보 가져오기 |
| 디자인에 있는 모든 구성 요소(콤포넌트) 나열 |
디자인 유형 안전
도구 | 설명 |
| 디자인이 파라메트릭 또는 다이렉트 모드인지 확인 |
| 디자인 유형 전환 (파라메트릭/다이렉트 리커버 포함) |
스케치
도구 | 설명 |
| xy/yz/xz 평면에 새 스케치 생성, 선택적 오프셋 |
| 가장 최근 스케치에 사각형 그리기 |
| 가장 최근 스케치에 원 그리기 |
| 가장 최근 스케치에 선 그리기 |
| 호 그리기 (중심 + 시작점 + 스윕 각도) |
| 맞춤형 또는 제어점 스플라인 그리기 |
| 정다각형 (3~64개 변) |
| 기하 구속 (일치, 평행, 접선 등) |
| 구동 치수 추가 (거리, 각도, 반경, 지름) |
| 연결된 스케치 곡선의 오프셋 |
| 교차점에서 곡선 자르기 |
| 가장 가까운 교차점까지 곡선 연장 |
| 모서리/본체를 스케치 평면에 투영 |
피처
도구 | 설명 |
| 스케치 프로필을 돌출 |
| 프로필을 축을 기준으로 회전 |
| 경로를 따라 프로필을 스윕 |
| 두 개 이상의 프로필 사이로프트 |
| 모서리 라운드 (전체/위/아래/수직) |
| 모서리 모따기 |
| 본체 속을 비우기 |
| 본체를 평면 기준으로 미리 |
| 본체 면에 구멍 피처 생성 |
| 행과 열로 패턴 생성 |
| 축 기준 원형 패턴 |
| 나사산 추가 (외형 또는 모델형) |
| 금형 이형을 위한 드래프트/테이퍼 면 생성 |
| 평면을 사용하여 본체 분할 |
| 본체 면 분할 |
| 면을 거리만큼 당기거나 밀기 |
| 본체 크기 비율 조정 (균일 또는 비균일) |
| 타임라인 일부 피처 억제 |
| 억제된 피처 다시 활성화 |
본체 작업
도구 | 설명 |
| 본체를 (x, y, z) 만큼 이동 |
| 본체 이름 변경 (최상위 및 모든 구성 요소 검색) |
| 두 본체 결합/빼기/교차 |
| 디자인 카드 초기화 |
| 이전 작업 실행 취소 (디자인 유형 안전 가드 포함) |
다이렉트 프리미티브
도구 | 설명 |
| 상자 생성 (TemporaryBRepManager 사용) |
| 원통 생성 |
| 구 생성 |
| 토러스 생성 |
서피스 작업
도구 | 설명 |
| 경계 모서리에서 패치 서피스 생성 |
| 서피스 본체를 하나로 스티치 |
| 서피스를 솔리드로 두께 조정 |
| 모서리에서 러어드 표면 생성 |
| 다른 본체로 서피스를 트림 |
판금
도구 | 설명 |
| 모서리에 플랜지 생성 |
| 벤드 추가 |
| 편평한 패턴 생성 |
| 특정 벤드 펼치기 |
구속조건 지오메트리
도구 | 설명 |
| 오프셋, 각도, 중간 평면, 3점, 접선 |
| 두 점, 교차, 모서리, 수직 |
어셈블리
도구 | 설명 |
| 서브어샘블리 component 생성 |
| 두 구성 요소 사이 조인트 생성 |
| 현재 위치 기준 조인트 생성 |
| 구성 요소를 함께 잠금 그룹 생성 |
검사 및 분석
도구 | 설명 |
| 엔티티 사이 최소 거리 측정 |
| 엔티티 사이 각도 측정 |
| 질량, 부피, 면적, 질량 중심 알아내기 |
| 모델을 통한 단면 분석 |
| 구성 요소 간 간섭 충돌 감지 |
외관
도구 | 설명 |
| 라이브러리에서 재질/외관 지정 |
파라미터
도구 | 설명 |
| 모든 사용자 파라미터 나열 |
| 새 파라미터 생성 |
| 파라미터 값 업데이트 |
| 파라미터 삭제 |
내보내기
도구 | 설명 |
| 본체를 STL로 내보냅니다 (구성 요소 내부 본체 지원) |
| 본체를 STEP로 내보냅니다 (구성 요소 내부 본체 지원) |
| 디자인을 Fusion 아카이브로 내보내기 |
CAM / 제조
도구 | 설명 |
| 가공 셋업 생성 (밀링/턴닝/커팅) |
| 가공 작업 추가 (페이스, 컨투어, adaptive, 드릴링 등) |
| 작업에 대한 툴패스 생성 |
| G-code로 후처리 (fanuc, grbl, haas 등) |
| 모든 가공 셋업 나열 |
| 셋업 내 작업 나열 |
| 작업 세부 정보 가져오기 (전략, 도구, 파라미터) |
코드 실행
도구 | 설명 |
| Fusion에서 임의의 Python 실행 (REPL 스타일) |
MCP 프로토콜 기능
도구 주석 — 각 도구에는
readOnlyHint,destructiveHint,idempotentHint가 태그되어 안전한 작업은 MCP 클라이언트가 자동 승인할 수 있습니다.리소스 —
fusion360://status,fusion360://design,fusion的360://parameters리소스를 통해 수동 상태 검사 가능리소스 템플릿 —
fusion360://body/{name},fusion360://component/{name}로 엔티티 조회 가능프롬프트 —
create-box,model-threaded-bolt,sheet-metal-enclosure워크플로 템플릿구조화된 오류 — add-in이 실패를 보고하면 도구 결과에
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의 내부 단위)입니다.
도구 호출당 하나의 처리만 수행합니다. 여러 개를 한꺼번에 처리하면 add-in이 중단될 수 있습니다.
명령은 30초 후에 시간 초과됩니다.
add-in은
~/fusion360mcp.log파일에 로그를 기록합니다.undo도구는 디자인 유형 안전 가드를 포함하고 있어, 실행 취소 후 파라메트릭에서 다이렉트 모드로 바뀌면 자동으로 다시 실행합니다.
감사의 글
BlenderMCP에서 영감을 받았습니다 — 소켓 브리지 아키텍처는 여기서 시작되었습니다.
또한 기존 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 PyPI147MIT
- 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