Fusion360 MCP Server
Fusion360 MCP Server
ベータ版 — このプロジェクトは現在活発に開発中です。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 Thread2つのコンポーネントから構成されています。
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 アドインをインストールする
クイックインストール (開発用のシンボリックリンク):
./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 → Shift→ Add-Ins → Fusion360MCP → Stop)
Fusion の AddIns ディレクトリからアドインのフォルダーを削除する
利用可能なツール (84)
シーンとクエリ
Tool | Description |
| ヘルスチェック (即時、Fusion API は使用しない) |
| デザイン名、ボディ、スケッチ、フィーチャ、カメラ |
| 指定した名前のボディまたはスケッチの詳細情報 |
| デザイン内のすべてのコンポーネントを一覧表示 |
デザインタイプの安全
Tool | Description |
| デザインがパラメトリックかダイレクトモードかを確認 |
| デザインタイプを切り替える (パラメトリック/ダイレクトの復元) |
スケッチ
Tool | Description |
| xy/yz/xz 平面に新しいスケッチを作成 (オフセット指定可) |
| 直近のスケッチに長方形を描画 |
| 直近のスケッチに円を描画 |
| 直近のスケッチに線を描画 |
| 円弧を描画 (中心 + 始点 + スイープ角度) |
| フィットポイントまたはコントロールポイントのスプラインを描画 |
| 正多角形を作成 (3〜64辺) |
| 幾何拘束 (一致、平行、接線など) を追加 |
| 駆動寸法を追加 (距離、角度、半径、直径) |
| 接続されたスケッチ曲線をオフセット |
| 交差点でトリム |
| 直近の交差点まで延長 |
| エッジ/ボディをスケッチ平面に投影 |
フィーチャ
Tool | Description |
| スケッチプロファイルを押し出す |
| プロファイルを軸の周りで回転 |
| プロファイルをパスに沿ってスイープ |
| 2つ以上のプロファイル間でロフト |
| エッジを丸める (すべて/上部/底部/垂直) |
| エッジを面取りする |
| ボディを中空化する |
| 平面を基準にボディをミラー |
| ボディの面に穴フィーチャを作成 |
| 行と列でパターンを作成 |
| 軸を中心にパターンを作成 |
| ねじを追加 (外観のみ または モデリング) |
| 型抜き用のドラフト/テーパーを付ける |
| 平面を使用してボディを分割 |
| ボディの面を分割 |
| 面を指定距離だけ押す/引く |
| 均一または非均一にスケール |
| 均一または非均一辺にスケール |
| タイムラインのフィーチャを抑制 (非表示にする) |
| 抑制されたフィーチャを再度有効化 |
ボディ操作
ツール | 説明 |
| ボディを (x, y, z) のあたいだけ移動 |
| ボディを改名 (ルートと全コンポーネントを検索) |
| 2つのボディを結合/ブールシミュレーション/交差 |
| デザインをクリア |
| 復元する (デザインタイプの安全ガード付き) |
ダイレクトプリミティブ
ツール | 説明 |
| ボックス (TemporaryBRepManager 経由) |
| 円柱 |
| 球体 |
| ドーナツ型 |
サーフェス操作
ツール | 説明 |
| 境界エッジからパッチサーフェスを作成 |
| サーフェスボディを1つに縫いあわせる |
| サーフェスを厚み付けしてソリッドにする |
| エッジからルールド サーフェスを作成 |
| 別のボディのスケッチでサーフェスをトリムする |
シートメタル
ツール | 説明 |
| エッジにフランジを作成 |
| 曲げを追加 |
| フラットパターンを作成 |
| 特定の曲げを展開 |
構築ジオメトリ
ツール | 説明 |
| オフセット、角度、距離、3点、接線 |
| 2点、交差、エッジ、垂直 |
アセンブリ
ツール | 説明 |
| サブアセンブリのサブコンポーネントを作成する |
| 2つのコンポーネント間のジョイント |
| 現在位置からジョイントを作成 |
| コンポーネイントを固定してリンクする |
検査と解析
ツール | 説明 |
| エンティティ同士の最小距離を測定する |
| エンティティ間の角度を測定 |
| 質量、体積、面積、重心 |
| モデルを横切る断面平面を作成する |
| コンポーネント間の干渉を検出する |
外観
ツール | 説明 |
| ライブラリから外観 (マテリアル) を割り当てる |
パラメータ
ツール | 説明 |
| すべてのユーザーパラメータを一覧表示する |
| 新しいパラメータを作成する |
| パラメータの値を更新する |
| パラメータを削除する |
エクスポート
ツール | 説明 |
| ボディを STL としてエクスポート (コンポーネント内のボディも対応) |
| ボディを STEP としてエクスポート (コンポーネント内のボディも対応) |
| デザインファイルを Fusion アーカイブとしてエクスポート |
CAM / 製造
ツール | 説明 |
| 製造セットアップを作成 (フライス / 旋削 / 切断) |
| 機械加工オペレーションを追加 (フェース、輪郭、アダプティブ、ドリルなど) |
| オペレーションのツールパスを生成する |
| ポストプロセスで G コードを生成 (ファンク、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-coverなどのワークフローテンプレート構造化エラー — アドインが失敗を報告すると、ツールの結果に
isError=Trueが含まれますモックモード —
--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 の内部単位)。
ツール呼び出しごとに1回の操作だけです。複数操作を一度に実行するとアドインがクラッシュします。
コマンドは 30 秒でタイムアウトします。
アドインは
~/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.80483 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