Fusion360 MCP 서버
베타 — 이 프로젝트는 현재 활발히 개발 중입니다. 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 서버 (본 저장소) — Claude와 MCP 프로토콜로 통신하고 TCP를 통해 명령을 전달하는 Python 프로세스
Fusion360MCP 애드인 (Fusion의 AddIns 폴더에 설치) — Fusion 360 내부에서 실행되며 메인 스레드에서 안전하게 API 호출을 실행
Related MCP server: Fusion360 LLM Assistant
사전 요구 사항
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 → Add-Ins → Fusion360MCP → Stop).
Fusion의 AddIns 디렉토리에서 애드인 폴더를 삭제합니다.
사용 가능한 도구 (84)
장면 및 쿼리
도구 | 설명 |
| 상태 확인 (즉시 실행, Fusion API 사용 안 함) |
| 디자인 이름, 바디, 스케치, 피처, 카메라 정보 |
| 이름이 지정된 바디 또는 스케치에 대한 상세 정보 |
| 디자인 내 모든 구성 요소 나열 |
디자인 유형 안전성
도구 | 설명 |
| 디자인이 파라메트릭 모드인지 다이렉트 모드인지 확인 |
| 디자인 유형 전환 (파라메트릭/다이렉트 복구) |
스케치
도구 | 설명 |
| xy/yz/xz 평면에 새 스케치 생성 (오프셋 옵션) |
| 최근 스케치에 사각형 그리기 |
| 최근 스케치에 원 그리기 |
| 최근 스케치에 선 그리기 |
| 호 그리기 (중심 + 시작 + 스윕 각도) |
| 맞춤점 또는 제어점 스플라인 |
| 정다각형 (3~64각형) |
| 기하학적 구속조건 (일치, 평행, 접선 등) |
| 구동 치수 (거리, 각도, 반지름, 지름) |
| 연결된 스케치 곡선 오프셋 |
| 교차점에서 자르기 |
| 가장 가까운 교차점까지 연장 |
| 스케치 평면에 모서리/바디 투영 |
피처
도구 | 설명 |
| 스케치 프로파일 돌출 |
| 축을 중심으로 프로파일 회전 |
| 경로를 따라 프로파일 스윕 |
| 두 개 이상의 프로파일 사이 로프트 |
| 모서리 라운딩 (전체/상단/하단/수직) |
| 모서리 모따기 |
| 바디 내부 비우기 |
| 평면을 기준으로 바디 대칭 복사 |
| 바디 면에 구멍 피처 생성 |
| 행과 열로 패턴 생성 |
| 축을 중심으로 패턴 생성 |
| 나사산 추가 (장식용 또는 모델링) |
| 금형 이형을 위한 면 구배/테이퍼 |
| 평면을 사용하여 바디 분할 |
| 바디의 면 분할 |
| 거리만큼 면 밀기/당기기 |
| 균일 또는 비균일 배율 조정 |
| 타임라인 피처 억제 |
| 억제된 피처 다시 활성화 |
바디 작업
도구 | 설명 |
| (x, y, z)만큼 바디 이동 |
| 바디 이름 변경 (루트 및 모든 구성 요소 검색) |
| 두 바디 결합/절단/교차 |
| 디자인 초기화 |
| 마지막 작업 취소 (디자인 유형 안전 가드 포함) |
다이렉트 프리미티브
도구 | 설명 |
| 상자 (TemporaryBRepManager 사용) |
| 원기둥 |
| 구 |
| 토러스 |
서피스 작업
도구 | 설명 |
| 경계 모서리에서 패치 서피스 생성 |
| 서피스 바디를 하나로 봉합 |
| 서피스를 솔리드로 두껍게 만들기 |
| 모서리에서 룰드 서피스 생성 |
| 다른 바디로 서피스 자르기 |
판금
도구 | 설명 |
| 모서리에 플랜지 생성 |
| 굽힘 추가 |
| 전개도 생성 |
| 특정 굽힘 펼치기 |
구성 기하학
도구 | 설명 |
| 오프셋, 각도, 중간 평면, 3점, 접선 |
| 2점, 교차, 모서리, 수직 |
어셈블리
도구 | 설명 |
| 하위 어셈블리 구성 요소 생성 |
| 두 구성 요소 간 조인트 |
| 현재 위치에서 조인트 생성 |
| 구성 요소들을 함께 고정 |
검사 및 분석
도구 | 설명 |
| 엔티티 간 최소 거리 |
| 엔티티 간 각도 |
| 질량, 부피, 면적, 질량 중심 |
| 모델을 통과하는 단면 평면 |
| 구성 요소 간 충돌 감지 |
외관
도구 | 설명 |
| 라이브러리에서 재질 외관 할당 |
매개변수
도구 | 설명 |
| 모든 사용자 매개변수 나열 |
| 새 매개변수 생성 |
| 매개변수 값 업데이트 |
| 매개변수 제거 |
내보내기
도구 | 설명 |
| 바디를 STL로 내보내기 (구성 요소 내 바디 지원) |
| 바디를 STEP으로 내보내기 (구성 요소 내 바디 지원) |
| 디자인을 Fusion 아카이브로 내보내기 |
CAM / 제조
도구 | 설명 |
| 제조 셋업 생성 (밀링/터닝/절단) |
| 가공 작업 추가 (페이스, 컨투어, 어댑티브, 드릴링 등) |
| 작업에 대한 툴패스 생성 |
| G-code로 포스트 프로세싱 (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포함모의 모드 —
--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에서 영감을 받았습니다. 소켓 브리지 아키텍처가 거기서 시작되었습니다.
또한 기존 Fusion 360 MCP 생태계의 아이디어를 기반으로 구축되었습니다:
라이선스
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/faust-machines/fusion360-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server