Skip to main content
Glama
shiguangzhe666

Fusion360 MCP Server

Fusion360 MCP Server

Beta — Este proyecto está en desarrollo activo. Las APIs y el comportamiento de las herramientas pueden cambiar entre versiones. Úsalo bajo tu propio criterio. Se agradecen comentarios e informes de errores a través de GitHub Issues.

Servidor MCP que conecta agentes de codificación de IA a Autodesk Fusion 360 para la automatización de CAD.

Probado, con frecuencia con Claude Code. Funciona con cualquier cliente compatible con MCP: OpenCode, Codex, Cursor o cualquier otro que hable el Model Context Protocol.

Cómo funciona

Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread

Dos componentes:

  1. MCP Server (este repositorio): proceso de Python que habla el protocolo MCP con Claude y reenvía comandos a través de TCP.

  2. Fusion360MCP Add-in (instalado en la carpeta AddIns de Fusion): se ejecuta dentro de Fusion 360, ejecuta llamadas a la API de forma segura en el hilo principal.

Related MCP server: Fusion360 MCP Server

Requisitos previos

  • uv (gestor de paquetes de Python)

  • Autodesk Fusion 360

  • Un cliente compatible con MCP (Claude Code, OpenCode, Codex, Cursor, etc.)

Instalación

1. Instala el complemento de Fusion 360

Instalación rápida (enlace simbólico para desarrollo):

./scripts/install-addon.sh

Instalación manual:

# 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"

Después, inicia Fuchsias: Shift+S → Add-Ins → Fusion360MCP → Run.

Deberías ver [MCP] Server listening on localhost:9876 en la ventana TEXT COMMANDS.

2. Conecta tu cliente MCP

El servidor MCP está publicado en PyPI: no necesitas clonar este repositorio.

Claude Code

claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

Otros clientes MCP

El servidor se ejecuta a través de stdio, por lo que cualquier cliente compatible con MCP puede lanzarlo. El comando es:

uvx fusion360-mcp-server --mode socket
{
  "mcpServers": {
    "fusion360": {
      "command": "uvx",
      "args": [
        "fusion360-mcp-server",
        "--mode", "socket"
      ]
    }
  }
}

3. Verificación

Llama a la herramienta ping desde tu cliente. Si devuelve {"pong": true}, todo está conectado.

Desinstalación

  1. Elimina la entrada fusion360 de la configuración de tu cliente MCP.

  2. Detén el complemento en Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop).

  3. Elimina la carpeta del complemento del directorio AddIns de Fusion.

Herramientas disponibles (8)

Escena y consulta

Tool

Description

ping

Comprobación de estado (instantánea, sin API de Fusion)

get_scene_info

Nombre del diseño, cuerpos, croquis, funciones y cámara

get_object_info

Información detallada de un cuerpo o croquis concreto

list_components

Lista todos los componentes del diseño

Seguridad del tipo de diseño

Tool

Description

get_design_type

Comprueba si el diseño está en modo paramétrico o directo

set_design_type

Cambia el tipo de diseño (paramétrico/directo con recuperación)

Croquis

Tool

Description

create_sketch

Nuevo croquis en el plano xy/yz/xz, con desplazamiento opcional

draw_rectangle

Rectángulo en el croquis más reciente

draw_circle

Círculo en el croquis más reciente

draw_line

Línea en el croquis más reciente

draw_arc

Arco (centro + inicio + ángulo de barrido)

draw_spline

Spline de puntos de ajuste o de puntos de control

create_polygon

Polígono regular (de 3 a 64 lados)

add_constraint

Restricción geométrica (coincidente, paralela, tangente, etc.)

add_dimension

Acotación controladora (distancia, ángulo, radial, diámetro)

offset_curve

Desplaza curvas de croquis conectadas

trim_curve

Recorta en las intersecciones

extend_curve

Extiende hasta la intersección más cercana

project_geometry

Proyecta aristas/cuerpos sobre el plano de croquis

Funciones

Tool

Description

extrude

Extruye un perfil de croquis

revolve

Gira un perfil alrededor de un eje

sweep

Barre un perfil a lo largo de una trayectoria

loft

Crea un loft entre dos o más perfiles

fillet

Redondea aristas (todas/superiores/inferiores/verticales)

chamfer

Achaflana aristas

shell

Vacía un cuerpo

mirror

Refleja un cuerpo respecto a un plano

create_hole

Crea una función de agujero en una cara de un cuerpo

rectangular_pattern

Patrón en filas y columnas

circular_pattern

Patrón alrededor de un eje

create_thread

Añade roscas (cosméticas o modeladas)

draft_faces

Crea ángulo de desmoldeo en las caras para eldesmoldeo

split_body

Divide un cuerpo usando un plano

split_face

Divide caras de un cuerpo

offset_faces

Empuja/tira de las caras una distancia

scale_body

Escala de forma uniforme o no uniforme

suppress_feature

Suprime una función de la línea de tiempo

unsuppress_feature

Reactiva una función suprimida

Operaciones con cuerpos

Tool

Description

move_body

Mueve un cuerpo según (x, y, z)

rename_body

Renombra un cuerpo (busca en la raíz y todos los componentes)

boolean_operation

Une, corta o interseciza dos cuerpos

delete_all

Borra todo el diseño

undo

Deshace la última operación (con protección para el tipo de diseño)

Primitivas directas

Tool

Description

create_box

Caja (mediante TemporaryBRepManager)

create_cylinder

Cilindro

create_sphere

Esfera

create_torus

Toroide

Operaciones de superficie

Tool

Description

patch_surface

Crea una superficie de parche a partir de aristas de contorno

stitch_surfaces

Cose cuerpos de superficie en uno

thicken_surface

Da espesor a una superficie para convertirla en sólido

ruled_surface

Superficie reglada a partir de una arista

trim_surface

Recorta una superficie con otro cuerpo

Chapa metálica

Tool

Description

create_flange

Crea una pestaña en una arista

create_bend

Añade un plegado

flat_pattern

Crea el patrón plano

unfold

Despliega plegados concretos

Geometría de construcción

Tool

Description

create_construction_plane

Desplazamiento, ángulo, plano medio, 3 puntos, tangente

create_construction_axis

Dos puntos, intersección, arista, perpendicular

Ensamblaje

Tool

Description

create_component

Crea un componente de subensamblaje

add_joint

Unión entre dos componentes

create_as_built_joint

Unión a partir de las posiciones actuales

create_rigid_group

Bloquea los componentes entre sí

Inspección y análisis

Tool

Description

measure_distance

Distancia mínima entre entidades

measure_angle

Ángulo entre entidades

get_physical_properties

Masa, volumen, área, centro de masa

create_section_analysis

Plano de sección a través del modelo

check_interference

Detecta colisiones entre componentes

Apariencia

Tool

Description

set_appearance

Asigna una apariencia de material desde la biblioteca

Parámetros

Tool

Description

get_parameters

Lista todos los parámetros de usuario

create_parameter

Crea un nuevo parámetro

set_parameter

Actualiza el valor de un parámetro

delete_parameter

Elimina un parámetro

Exportación

Tool

Description

export_stl

Exporta un cuerpo como STL (admite cuerpos dentro de componentes)

export_step

Exporta un cuerpo como STEP (admite cuerpos dentro de componentes)

export_f3d

Exporta el diseño como archivo de Fusion

CAM / Fabricación

Tool

Description

cam_create_setup

Crea una configuración de fabricación (fresado, torneado, corte)

cam_create_operation

Añade una operación de mecanizado (planeado, contorneado, adaptativo, taladrado, etc.)

cam_generate_toolpath

Genera trayectorias de herramienta para las operaciones

cam_post_process

Postprocesa a G-code (fanuc, grbl, haas, etc.)

cam_list_setups

Lista todas las configuraciones de fabricación

cam_list_operations

Lista las operaciones de una configuración

cam_get_operation_info

Obtiene detalles de la operación (estrategia, herramienta, parámetros)

Ejecución de código

Tool

Description

execute_code

Ejecuta código Python arbitrario en Fusion (estilo REPL)

Características del protocolo MCP

  • Anotaciones de herramientas — cada herramienta está etiquetada con readOnlyHint, destructiveHint e idempotentHint para que los clientes MCP puedan aprobar automáticamente las operaciones seguras.

  • Recursosfusion360://status, fusion360://design, fusion360://parameters para inspección pasiva del estado.

  • Plantillas de recursosfusion360://body/{name}, fusion360://component/{name} para búsqueda dinámica de entidades.

  • Prompts — plantillas de flujos de trabajo create-box, model-threaded-bolt, sheet-metal-enclosure.

  • Errores estructurados — los resultados de las herramientas incluyen isError=True cuando el complemento notifica errores.

  • Modo mock--mode mock devuelve datos de prueba plausibles sin que Fusion esté en ejecución (todas las respuestas incluyen "mode": "mock").

Desarrollo

uv sync --dev       # install deps
uv run pytest -v    # run tests (171 tests)
uv run ruff check   # lint

Notas

  • Todas las unidades de la API de Fusion son centímetros (unidad interna de Fusion).

  • Una operación por llamada. Procesar varias operaciones juntas tumba el complemento.

  • Los comandos expiran a los 30 segundos.

  • El complemento registra en ~/fusion360mcp.log.

  • La herramienta undo incluye una protección para el tipo de diseño: comprueba antes y después, y reprimeratiza automáticamente si el deshacer pasara del modo paramétrico al directo.

Agradecimientos

Inspirado en BlenderMCP; la arquitectura de puente de socket se originó allí.

También se basa en ideas del ecosistema MCP de Fusion 360 existente:

Licencia

MIT

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

  • 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
  • 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
  • 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