Skip to main content
Glama
Fusion360 MCP Server

Fusion360 MCP Server

by forgemorrow

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 Thread

2つのコンポーネントから構成されています。

  1. MCP Server (このリポジトリ) — Claude と MCP プロトコルで通信し、TCP 経由でコマンドを転送する Python プロセス

  2. 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} が返されれば、すべて正常に接続されています。

アンインストール

  1. MCP クライアント設定から fusion360 エントリを削除する

  2. Fusion でアドインを停止する (Shift+S → Shift→ Add-Ins → Fusion360MCP → Stop)

  3. Fusion の AddIns ディレクトリからアドインのフォルダーを削除する

利用可能なツール (84)

シーンとクエリ

Tool

Description

ping

ヘルスチェック (即時、Fusion API は使用しない)

get_scene_info

デザイン名、ボディ、スケッチ、フィーチャ、カメラ

get_object_info

指定した名前のボディまたはスケッチの詳細情報

list_components

デザイン内のすべてのコンポーネントを一覧表示

デザインタイプの安全

Tool

Description

get_design_type

デザインがパラメトリックかダイレクトモードかを確認

set_design_type

デザインタイプを切り替える (パラメトリック/ダイレクトの復元)

スケッチ

Tool

Description

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

エッジ/ボディをスケッチ平面に投影

フィーチャ

Tool

Description

extrude

スケッチプロファイルを押し出す

revolve

プロファイルを軸の周りで回転

sweep

プロファイルをパスに沿ってスイープ

loft

2つ以上のプロファイル間でロフト

fillet

エッジを丸める (すべて/上部/底部/垂直)

chamfer

エッジを面取りする

shell

ボディを中空化する

mirror

平面を基準にボディをミラー

create_hole

ボディの面に穴フィーチャを作成

rectangular_pattern

行と列でパターンを作成

circular_pattern

軸を中心にパターンを作成

create_thread

ねじを追加 (外観のみ または モデリング)

draft_faces

型抜き用のドラフト/テーパーを付ける

split_body

平面を使用してボディを分割

split_face

ボディの面を分割

offset_faces

面を指定距離だけ押す/引く

assign_scale

均一または非均一にスケール

scale_body

均一または非均一辺にスケール

suppress_feature

タイムラインのフィーチャを抑制 (非表示にする)

unsuppress_feature

抑制されたフィーチャを再度有効化

ボディ操作

ツール

説明

move_body

ボディを (x, y, z) のあたいだけ移動

rename_body

ボディを改名 (ルートと全コンポーネントを検索)

boolean_operation

2つのボディを結合/ブールシミュレーション/交差

delete_all

デザインをクリア

undo

復元する (デザインタイプの安全ガード付き)

ダイレクトプリミティブ

ツール

説明

create_box

ボックス (TemporaryBRepManager 経由)

create_cylinder

円柱

create_sphere

球体

create_torus

ドーナツ型

サーフェス操作

ツール

説明

patch_surface

境界エッジからパッチサーフェスを作成

stitch_surfaces

サーフェスボディを1つに縫いあわせる

thicken_surface

サーフェスを厚み付けしてソリッドにする

ruled_surface

エッジからルールド サーフェスを作成

trim_surface

別のボディのスケッチでサーフェスをトリムする

シートメタル

ツール

説明

create_flange

エッジにフランジを作成

create_bend

曲げを追加

flat_pattern

フラットパターンを作成

unfold

特定の曲げを展開

構築ジオメトリ

ツール

説明

create_construction_plane

オフセット、角度、距離、3点、接線

create_construction_axis

2点、交差、エッジ、垂直

アセンブリ

ツール

説明

create_component

サブアセンブリのサブコンポーネントを作成する

add_joint

2つのコンポーネント間のジョイント

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 コードを生成 (ファンク、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-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 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.
      80
      483 PyPI
      147
      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