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.
Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main ThreadDos componentes:
MCP Server (este repositorio): proceso de Python que habla el protocolo MCP con Claude y reenvía comandos a través de TCP.
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: Fusion MCP para Codex
uv (gestor de paquetes de Python)
Autodesk Fusion 360
Un cliente compatible con MCP (Claude Code, OpenCode, Codex, Cursor, etc.)
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"Después, inicia Fuchsias: Shift+S → Add-Ins → Fusion360MCP → Run.
Deberías ver [MCP] Server listening on localhost:9876 en la ventana TEXT COMMANDS.
El servidor MCP está publicado en PyPI: no necesitas clonar este repositorio.
claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socketEl 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"
]
}
}
}Llama a la herramienta ping desde tu cliente. Si devuelve {"pong": true}, todo está conectado.
Elimina la entrada fusion360 de la configuración de tu cliente MCP.
Detén el complemento en Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop).
Elimina la carpeta del complemento del directorio AddIns de Fusion.
Tool | Description |
| Comprobación de estado (instantánea, sin API de Fusion) |
| Nombre del diseño, cuerpos, croquis, funciones y cámara |
| Información detallada de un cuerpo o croquis concreto |
| Lista todos los componentes del diseño |
Tool | Description |
| Comprueba si el diseño está en modo paramétrico o directo |
| Cambia el tipo de diseño (paramétrico/directo con recuperación) |
Tool | Description |
| Nuevo croquis en el plano xy/yz/xz, con desplazamiento opcional |
| Rectángulo en el croquis más reciente |
| Círculo en el croquis más reciente |
| Línea en el croquis más reciente |
| Arco (centro + inicio + ángulo de barrido) |
| Spline de puntos de ajuste o de puntos de control |
| Polígono regular (de 3 a 64 lados) |
| Restricción geométrica (coincidente, paralela, tangente, etc.) |
| Acotación controladora (distancia, ángulo, radial, diámetro) |
| Desplaza curvas de croquis conectadas |
| Recorta en las intersecciones |
| Extiende hasta la intersección más cercana |
| Proyecta aristas/cuerpos sobre el plano de croquis |
Tool | Description |
| Extruye un perfil de croquis |
| Gira un perfil alrededor de un eje |
| Barre un perfil a lo largo de una trayectoria |
| Crea un loft entre dos o más perfiles |
| Redondea aristas (todas/superiores/inferiores/verticales) |
| Achaflana aristas |
| Vacía un cuerpo |
| Refleja un cuerpo respecto a un plano |
| Crea una función de agujero en una cara de un cuerpo |
| Patrón en filas y columnas |
| Patrón alrededor de un eje |
| Añade roscas (cosméticas o modeladas) |
| Crea ángulo de desmoldeo en las caras para eldesmoldeo |
| Divide un cuerpo usando un plano |
| Divide caras de un cuerpo |
| Empuja/tira de las caras una distancia |
| Escala de forma uniforme o no uniforme |
| Suprime una función de la línea de tiempo |
| Reactiva una función suprimida |
Tool | Description |
| Mueve un cuerpo según (x, y, z) |
| Renombra un cuerpo (busca en la raíz y todos los componentes) |
| Une, corta o interseciza dos cuerpos |
| Borra todo el diseño |
| Deshace la última operación (con protección para el tipo de diseño) |
Tool | Description |
| Caja (mediante TemporaryBRepManager) |
| Cilindro |
| Esfera |
| Toroide |
Tool | Description |
| Crea una superficie de parche a partir de aristas de contorno |
| Cose cuerpos de superficie en uno |
| Da espesor a una superficie para convertirla en sólido |
| Superficie reglada a partir de una arista |
| Recorta una superficie con otro cuerpo |
Tool | Description |
| Crea una pestaña en una arista |
| Añade un plegado |
| Crea el patrón plano |
| Despliega plegados concretos |
Tool | Description |
| Desplazamiento, ángulo, plano medio, 3 puntos, tangente |
| Dos puntos, intersección, arista, perpendicular |
Tool | Description |
| Crea un componente de subensamblaje |
| Unión entre dos componentes |
| Unión a partir de las posiciones actuales |
| Bloquea los componentes entre sí |
Tool | Description |
| Distancia mínima entre entidades |
| Ángulo entre entidades |
| Masa, volumen, área, centro de masa |
| Plano de sección a través del modelo |
| Detecta colisiones entre componentes |
Tool | Description |
| Asigna una apariencia de material desde la biblioteca |
Tool | Description |
| Lista todos los parámetros de usuario |
| Crea un nuevo parámetro |
| Actualiza el valor de un parámetro |
| Elimina un parámetro |
Tool | Description |
| Exporta un cuerpo como STL (admite cuerpos dentro de componentes) |
| Exporta un cuerpo como STEP (admite cuerpos dentro de componentes) |
| Exporta el diseño como archivo de Fusion |
Tool | Description |
| Crea una configuración de fabricación (fresado, torneado, corte) |
| Añade una operación de mecanizado (planeado, contorneado, adaptativo, taladrado, etc.) |
| Genera trayectorias de herramienta para las operaciones |
| Postprocesa a G-code (fanuc, grbl, haas, etc.) |
| Lista todas las configuraciones de fabricación |
| Lista las operaciones de una configuración |
| Obtiene detalles de la operación (estrategia, herramienta, parámetros) |
Tool | Description |
| Ejecuta código Python arbitrario en Fusion (estilo REPL) |
Anotaciones de herramientas — cada herramienta está etiquetada con readOnlyHint, destructiveHint e idempotentHint para que los clientes MCP puedan aprobar automáticamente las operaciones seguras.
Recursos — fusion360://status, fusion360://design, fusion360://parameters para inspección pasiva del estado.
Plantillas de recursos — fusion360://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").
uv sync --dev # install deps
uv run pytest -v # run tests (171 tests)
uv run ruff check # lintTodas 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.
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:
MIT
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 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 a joint between two components
Inputs: component_one (required), component_two (required), joint_type.
Combine two named bodies (join/cut/intersect)
Inputs: tool_body (required), target_body (required), operation.
Add a machining operation to a setup. Strategy determines the toolpath type.
Inputs: strategy (required), setup_name (required), name, coolant, +6 more.
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.
Generate toolpaths for a specific operation or all operations in a setup
Inputs: setup_name, generate_all, operation_name.
Get details about a specific operation (strategy, tool, parameters, toolpath status)
Inputs: setup_name (required), operation_name (required).
List operations within a setup
Inputs: setup_name (required).
List all manufacturing setups in the document
Inputs: no named parameters.
Post-process toolpaths to generate NC code (G-code)
Inputs: setup_name (required), output_units, output_folder, operation_name, +1 more.
Chamfer edges of a body
Inputs: distance (required), body_name, body_index, edge_selection.
Detect collisions between components/bodies
Inputs: component_names (required), include_coincident_faces.
Pattern a body around an axis
Inputs: count (required), body_name (required), axis, total_angle.
Create a joint from components' current positions (easier than geometric joints)
Inputs: joint_type (required), component_one (required), component_two (required).
Add a bend to a sheet metal body
Inputs: body_name (required), angle, bend_radius, bend_line_sketch.
Create a box primitive (non-parametric via TemporaryBRepManager)
Inputs: width (required), height (required), length (required), center_x, +2 more.
Create a new component (sub-assembly) in the design
Inputs: name (required), parent_name.
Create a construction axis
Inputs: method (required), body_name, plane_one, plane_two, +3 more.
Create a construction plane for sketching
Inputs: method (required), angle, plane, offset, +6 more.
Create a cylinder primitive (non-parametric via TemporaryBRepManager)
Inputs: height (required), radius (required), axis, base_x, +2 more.
Create a sheet metal flange on an edge
Inputs: body_name (required), edge_index (required), angle, height, +1 more.
Create a hole feature on a body face
Inputs: depth (required), diameter (required), center_x, center_y, +3 more.
Create a new user parameter
Inputs: name (required), unit (required), value (required), comment.
Draw a regular polygon in the most recent sketch
Inputs: sides (required), radius (required), center_x, center_y, +1 more.
Lock multiple components together
Inputs: component_names (required), include_children.
Cut a section plane through the model
Inputs: plane, offset.
Create a new sketch on xy/yz/xz plane, optionally offset
Inputs: plane, z_offset.
Create a sphere primitive (non-parametric via TemporaryBRepManager)
Inputs: radius (required), center_x, center_y, center_z.
Add threads to a cylindrical face (cosmetic or modeled)
Inputs: body_name (required), face_index (required), is_modeled, is_internal, +5 more.
Create a torus primitive (non-parametric via TemporaryBRepManager)
Inputs: major_radius (required), minor_radius (required), axis, center_x, +2 more.
Clear the design (delete all timeline items)
Inputs: no named parameters.
Remove a user parameter
Inputs: name (required).
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 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 a circle in the most recent sketch
Inputs: radius (required), center_x, center_y, center_z.
Draw a line in the most recent sketch
Inputs: end_x (required), end_y (required), start_x (required), start_y (required), +2 more.
Draw a rectangle in the most recent sketch
Inputs: width (required), height (required), origin_x, origin_y, +1 more.
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.
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 the design as a native Fusion 360 archive (.f3d)
Inputs: file_path.
Export a body or component as a STEP file
Inputs: body_name (required), file_path.
Export a named body as an STL file
Inputs: body_name (required), file_path.
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 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.
Extrude a sketch profile
Inputs: height (required), direction, operation, profile_index.
Round edges of a body
Inputs: radius (required), body_name, body_index, edge_selection.
Create a flat pattern from a sheet metal body
Inputs: body_name (required).
Check if the design is in parametric or direct mode. Use this to detect accidental mode switches.
Inputs: no named parameters.
Get detailed info about a named body or sketch
Inputs: name (required).
List all user parameters in the design
Inputs: no named parameters.
Get mass, volume, surface area, center of mass, and density of a body
Inputs: body_name (required), accuracy.
Get design name, bodies, sketches, features, camera info
Inputs: no named parameters.
List all components in the design
Inputs: no named parameters.
Loft between two or more sketch profiles
Inputs: profile_sketch_names (required), operation.
Measure angle between two entities
Inputs: entity_one (required), entity_two (required).
Measure minimum distance between two entities
Inputs: entity_one (required), entity_two (required).
Mirror a body across a construction plane
Inputs: mirror_plane (required), body_name, body_index.
Translate a named body by (x, y, z)
Inputs: body_name (required), x, y, z.
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.
Push/pull faces of a body by a distance
Inputs: distance (required), body_name (required), face_indices, face_selection.
Create a patch surface from boundary edges
Inputs: sketch_name (required), continuity, profile_index.
Health check — returns immediately without touching Fusion API
Inputs: no named parameters.
Project edges or bodies onto the active sketch plane
Inputs: source_name (required), is_linked, sketch_name.
Pattern a body in rows and columns
Inputs: body_name (required), x_count, y_count, x_spacing, +1 more.
Rename a body (searches root and all components)
Inputs: new_name (required), body_name (required).
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.
Revolve a sketch profile around an axis
Inputs: angle (required), operation, axis_origin_x, axis_origin_y, +5 more.
Create a ruled surface from an edge or sketch curve
Inputs: body_name (required), edge_index (required), distance, rule_type.
Scale a body uniformly or non-uniformly
Inputs: scale (required), body_name (required), scale_x, scale_y, +4 more.
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.
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).
Update the value of an existing user parameter
Inputs: name (required), value (required).
Hollow out a body by removing a face
Inputs: thickness (required), body_name, body_index, face_selection.
Split a body using a plane or face
Inputs: body_name (required), extend_tool, splitting_body, splitting_plane.
Split faces of a body using a plane
Inputs: body_name (required), extend_tool, face_indices, splitting_plane.
Stitch surface bodies into a single body
Inputs: body_names (required), tolerance.
Suppress (disable) a feature in the timeline
Inputs: feature_name (required).
Sweep a sketch profile along a path (sketch curve)
Inputs: profile_index (required), path_sketch_name (required), operation, path_curve_index.
Thicken a surface body into a solid
Inputs: body_name (required), thickness (required), direction.
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 a surface body with another body
Inputs: body_name (required), tool_name (required).
Undo the last operation
Inputs: no named parameters.
Unfold specific bends in a sheet metal body
Inputs: body_name (required), bend_indices.
Unsuppress (re-enable) a feature in the timeline
Inputs: feature_name (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 85 tools
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.
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.
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.
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.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
