fusion

This Fusion 360 MCP server exposes Fusion 360 functionality to MCP-enabled AI agents. The server runs as a Fusion 360 add-in and bridges CAD operations, design data, and prompts to external agents via the MCP protocol. You can query resources like the active document, design structure, and parameters; invoke tools such as creating sketches, adding parameters, or displaying message boxes; and access specialized prompts to guide CAD tasks. To test locally, use the included client.py utility to exercise the API and verify connectivity. The server’s MCP implementation supports both HTTP SSE communication and a file-based fallback, ensuring compatibility in environments where direct network access is restricted.

Prerequisites:

• Autodesk Fusion 360 installed
• Python 3.7+ available inside Fusion 360’s Python environment (or accessible for testing via the provided scripts)
• MCP Python SDK installed in Fusion 360’s Python environment (pip install "mcp[cli]")

Step 1: Install MCP in Fusion 360’s Python Environment

• Using the installer script (recommended): python install_mcp_for_fusion.py This script discovers Fusion 360 Python installations and installs the MCP package with CLI extras in each one.

• Manual installation (if the installer script cannot be used):

  1. Locate Fusion 360’s Python executable (typically under Autodesk\webdeploy\production[version]\Python)
  2. Run: "[Fusion Python Path]\python.exe" -m pip install "mcp[cli]"

Step 2: Install the Fusion 360 Add-in

1. In Fusion 360, go to Tools -> Add-Ins -> Scripts and Add-Ins
2. Click the green + button in the My Add-Ins tab
3. Browse to and select the MCPserve folder from this repository
4. Click Open to add it
5. Select the MCPserve add-in and click Run to start it

Step 3: Run and Test

• Use the included client.py to test the server: python client.py --test-connection

• Test specific capabilities: python client.py --test-message-box python client.py --list-resources python client.py --list-tools python client.py --list-prompts

Notes and tips:

• Fusion 360 runs the MCP server as an add-in; external startup is not required beyond enabling the add-in within Fusion 360.
• The MCP Python SDK is used inside Fusion 360’s Python environment; ensure the environment used by Fusion 360 has the mcp[cli] extras installed.
• If you encounter connectivity issues, leverage the file-based MCP communication fallback by placing commands in the mcp_comm directory as described in the README.
• The server exposes resources (fusion://active-document-info, fusion://design-structure, fusion://parameters), tools (message_box, create_new_sketch, create_parameter), and prompts (create_sketch_prompt, parameter_setup_prompt). Use the client utility to explore and verify each capability.
• If running in a restricted environment, prefer the HTTP SSE endpoint at http://127.0.0.1:3000/sse, otherwise rely on the file-based method for robustness.