Servidor MCP para Fusion360
Beta — Este proyecto está en desarrollo activo. Las API y el comportamiento de las herramientas pueden cambiar entre versiones. Úselo bajo su propia discreción. Los comentarios y los informes de errores son bienvenidos a través de GitHub Issues.
Servidor MCP que conecta agentes de codificación de IA a Autodesk Fusion 360 para la automatización CAD.
Probado con Claude Code. Funciona con cualquier cliente compatible con MCP: OpenCode, Codex, Cursor o cualquier cosa que utilice el Model Context Protocol.
Cómo funciona
Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main ThreadDos componentes:
Servidor MCP (este repositorio) — Proceso de Python que habla el protocolo MCP con Claude y reenvía comandos a través de TCP
Complemento Fusion360MCP (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 LLM Assistant
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. Instalar el complemento de Fusion 360
Instalación rápida (enlace simbólico para desarrollo):
./scripts/install-addon.shInstalació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"Luego inícielo en Fusion: Shift+S → Add-Ins → Fusion360MCP → Run
Debería ver [MCP] Server listening on localhost:9876 en la ventana de COMANDOS DE TEXTO.
2. Conectar su cliente MCP
El servidor MCP está publicado en PyPI — no es necesario clonar este repositorio.
Claude Code
claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socketOtros clientes MCP
El servidor se ejecuta sobre stdio, por lo que cualquier cliente compatible con MCP puede iniciarlo. El comando es:
uvx fusion360-mcp-server --mode socket{
"mcpServers": {
"fusion360": {
"command": "uvx",
"args": [
"fusion360-mcp-server",
"--mode", "socket"
]
}
}
}3. Verificar
Llame a la herramienta ping desde su cliente. Si devuelve {"pong": true}, todo está conectado.
Desinstalación
Elimine la entrada
fusion360de la configuración de su cliente MCPDetenga el complemento en Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop)
Elimine la carpeta del complemento del directorio AddIns de Fusion
Herramientas disponibles (84)
Escena y consulta
Herramienta | Descripción |
| Comprobación de estado (instantánea, sin API de Fusion) |
| Nombre del diseño, cuerpos, bocetos, características, cámara |
| Información detallada sobre un cuerpo o boceto nombrado |
| Listar todos los componentes en el diseño |
Seguridad de tipo de diseño
Herramienta | Descripción |
| Comprobar si el diseño está en modo paramétrico o directo |
| Cambiar el tipo de diseño (recuperación paramétrica/directa) |
Bocetos
Herramienta | Descripción |
| Nuevo boceto en el plano xy/yz/xz, desplazamiento opcional |
| Rectángulo en el boceto más reciente |
| Círculo en el boceto más reciente |
| Línea en el boceto más reciente |
| Arco (centro + inicio + ángulo de barrido) |
| Spline de puntos de ajuste o puntos de control |
| Polígono regular (3–64 lados) |
| Restricción geométrica (coincidente, paralela, tangente, etc.) |
| Dimensión conductora (distancia, ángulo, radial, diámetro) |
| Desplazar curvas de boceto conectadas |
| Recortar en intersecciones |
| Extender a la intersección más cercana |
| Proyectar bordes/cuerpos en el plano de boceto |
Características
Herramienta | Descripción |
| Extruir un perfil de boceto |
| Revolucionar un perfil alrededor de un eje |
| Barrer un perfil a lo largo de una ruta |
| Loft entre dos o más perfiles |
| Bordes redondeados (todos/superior/inferior/vertical) |
| Bordes biselados |
| Vaciar un cuerpo |
| Reflejar un cuerpo a través de un plano |
| Característica de orificio en una cara del cuerpo |
| Patrón en filas y columnas |
| Patrón alrededor de un eje |
| Agregar roscas (cosméticas o modeladas) |
| Caras de inclinación/desmoldeo para liberación de molde |
| Dividir un cuerpo usando un plano |
| Dividir caras de un cuerpo |
| Empujar/tirar de caras a una distancia |
| Escalar de forma uniforme o no uniforme |
| Suprimir una característica de la línea de tiempo |
| Reactivar una característica suprimida |
Operaciones de cuerpo
Herramienta | Descripción |
| Trasladar un cuerpo por (x, y, z) |
| Cambiar el nombre de un cuerpo (busca en la raíz y en todos los componentes) |
| Unir/cortar/intersecar dos cuerpos |
| Borrar el diseño |
| Deshacer la última operación (con protección de seguridad de tipo de diseño) |
Primitivas directas
Herramienta | Descripción |
| Caja (vía TemporaryBRepManager) |
| Cilindro |
| Esfera |
| Toroide |
Operaciones de superficie
Herramienta | Descripción |
| Crear una superficie de parche a partir de bordes de contorno |
| Unir cuerpos de superficie en uno solo |
| Engrosar una superficie en un sólido |
| Superficie reglada a partir de un borde |
| Recortar una superficie con otro cuerpo |
Chapa metálica
Herramienta | Descripción |
| Crear una brida en un borde |
| Agregar una curva |
| Crear patrón plano |
| Desplegar curvas específicas |
Geometría de construcción
Herramienta | Descripción |
| Desplazamiento, ángulo, plano medio, 3 puntos, tangente |
| Dos puntos, intersección, borde, perpendicular |
Ensamblaje
Herramienta | Descripción |
| Crear un componente de subensamblaje |
| Unión entre dos componentes |
| Unión desde las posiciones actuales |
| Bloquear componentes juntos |
Inspección y análisis
Herramienta | Descripción |
| Distancia mínima entre entidades |
| Ángulo entre entidades |
| Masa, volumen, área, centro de masa |
| Plano de sección a través del modelo |
| Detectar colisiones entre componentes |
Apariencia
Herramienta | Descripción |
| Asignar apariencia de material desde la biblioteca |
Parámetros
Herramienta | Descripción |
| Listar todos los parámetros de usuario |
| Crear un nuevo parámetro |
| Actualizar un valor de parámetro |
| Eliminar un parámetro |
Exportar
Herramienta | Descripción |
| Exportar cuerpo como STL (admite cuerpos dentro de componentes) |
| Exportar cuerpo como STEP (admite cuerpos dentro de componentes) |
| Exportar diseño como archivo de Fusion |
CAM / Fabricación
Herramienta | Descripción |
| Crear una configuración de fabricación (fresado/torneado/corte) |
| Agregar una operación de mecanizado (cara, contorno, adaptativo, perforación, etc.) |
| Generar trayectorias de herramientas para operaciones |
| Post-procesar a código G (fanuc, grbl, haas, etc.) |
| Listar todas las configuraciones de fabricación |
| Listar operaciones en una configuración |
| Obtener detalles de la operación (estrategia, herramienta, parámetros) |
Ejecución de código
Herramienta | Descripción |
| Ejecutar Python arbitrario en Fusion (estilo REPL) |
Características del protocolo MCP
Anotaciones de herramientas — cada herramienta está etiquetada con
readOnlyHint,destructiveHintyidempotentHintpara que los clientes MCP puedan aprobar automáticamente operaciones segurasRecursos —
fusion360://status,fusion360://design,fusion360://parameterspara la inspección pasiva del estadoPlantillas de recursos —
fusion360://body/{name},fusion360://component/{name}para la búsqueda dinámica de entidadesPrompts — plantillas de flujo de trabajo
create-box,model-threaded-bolt,sheet-metal-enclosureErrores estructurados — los resultados de la herramienta incluyen
isError=Truecuando el complemento informa fallosModo simulado —
--mode mockdevuelve datos de prueba plausibles sin que Fusion se ejecute (todas las respuestas incluyen"mode": "mock")
Desarrollo
uv sync --dev # install deps
uv run pytest -v # run tests (171 tests)
uv run ruff check # lintNotas
Todas las unidades de la API de Fusion son centímetros (unidad interna de Fusion).
Una operación por llamada de herramienta. El procesamiento por lotes de múltiples operaciones bloquea el complemento.
Los comandos se agotan después de 30 segundos.
El complemento registra en
~/fusion360mcp.log.La herramienta
undoincluye una protección de seguridad de tipo de diseño: verifica antes/después y vuelve a realizar automáticamente si el deshacer cambiara de modo paramétrico a directo.
Agradecimientos
Inspirado en BlenderMCP — la arquitectura de puente de socket se originó allí.
También construido sobre ideas del ecosistema MCP de Fusion 360 existente:
Licencia
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
