Skip to main content
Glama
deenesjakoruzh
shiguangzhe666

Fusion360 MCP Server

by shiguangzhe666
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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

두 가지 구성 요소로 이루어져 있습니다.

  1. MCP Server (이 저장소) — Claude와 MCP 프로토콜로 통신하고 TCP로 명령을 전달하는 Python 프로세스

  2. Fusion360MCP Add-in (Fusion의 AddIns 폴더에 설치) — Fusion 360 내부에서 실행되며 메인 스레드에서 API 호출을 안전하게 수행

Related MCP server: Fusion360 MCP Server

필수 요구 사항

  • 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}가 반환되면 모든 것이 연결된 것입니다.

제거

  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

평면을 사용하여 본체 분할

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

오프셋, 각도, 중간 평면, 3점, 접선

create_construction_ast

두 점, 교차, 모서리, 수직

어셈블리

도구

설명

create_component

서브어샘블리 component 생성

add_joint

두 구성 요소 사이 조인트 생성

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

가공 작업 추가 (페이스, 컨투어, adaptive, 드릴링 등)

cam_generate_toolpath

작업에 대한 툴패스 생성

cam_post_process

G-code로 후처리 (fanuc, grbl, haas 등)

cam_list_operations

모든 가공 셋업 나열

cam_list_operations

셋업 내 작업 나열

cam_get_operation_info

작업 세부 정보 가져오기 (전략, 도구, 파라미터)

코드 실행

도구

설명

execute_code

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

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Fusion360 LLM Assistant

    ferocknew
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language 3D modeling in Fusion 360 through an MCP server that translates user commands into Fusion 360 API calls. Supports creating, editing, and managing 3D objects, executing Python code, and capturing model views through conversational interactions.
    1
    MIT

  • Fusion360 MCP Server

    faust-machines
    A
    license
    B
    quality
    D
    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
    77
    MIT

  • fusion-mcp

    prim-design
    A
    license
    Not graded
    quality
    D
    maintenance
    Open-source MCP server for controlling Autodesk Fusion 360 from any AI agent, enabling 3D modeling operations via natural language.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shiguangzhe666/Fusion360-MCP-AICAD'

If you have feedback or need assistance with the MCP directory API, please join our Discord server