Fusion-MCP-Server

# Fusion 360 MCP Server Master Control Program (MCP) server for Autodesk Fusion 360 that enables remote control and automation of Fusion 360 operations. ## Overview This project implements a client-server architecture that allows external applications to interact with Fusion 360. The server acts as a bridge between clients and the Fusion 360 API, enabling remote execution of commands and retrieval of model information. ## Components The project consists of three main components: 1. **MCP Server** (`server.py`): A standalone Python server that listens for connections from clients and communicates with Fusion 360. 2. **MCP Client** (`client.py`): A Python client library that connects to the MCP server and provides methods for sending commands and receiving responses. 3. **Fusion 360 Add-in** (`fusion360_mcp_addin.py`): A Fusion 360 add-in that connects to the MCP server and provides the actual integration with the Fusion 360 API. ## Installation ### Server and Client 1. Clone this repository or copy the files to your desired location. 2. Make sure you have Python 3.6+ installed. 3. No additional Python packages are required for basic functionality as the implementation uses only standard library modules. 4. To enable LLM features, install the optional `openai` package: ```bash pip install openai ``` ### Fusion 360 Add-in 1. Copy the entire folder containing `fusion360_mcp_addin.py`, `client.py`, and the `resources` directory to your Fusion 360 **AddIns** directory. Ensure the `resources/MCPIcon` folder contains the required icon files (`32x32-normal.png` and `16x16-normal.png`). 2. In Fusion 360, open the "Scripts and Add-ins" dialog (press `Shift+S` or find it in the "Design" workspace under "Utilities"). 3. On the "Add-ins" tab choose **Load from my computer** ("Load from Device" on some versions) and select this folder. Selecting the folder starts the add-in. 4. Click "Run" or enable "Run on Startup" to have it automatically load when Fusion 360 starts. ## Usage ### Starting the Server 1. Open a command prompt or terminal. 2. Navigate to the directory containing the server files. 3. Run the server: ``` python server.py ``` By default, the server will listen on `127.0.0.1:8080`. You can modify the host and port in the code if needed. Set the `OPENAI_API_KEY` environment variable if you plan to use the LLM integration. ### Connecting Fusion 360 to the Server 1. Start Fusion 360 and make sure the MCP add-in is running. 2. In Fusion 360, look for the "MCP Controls" panel. 3. Click the "Connect to MCP Server" button. 4. Enter the server host and port, then click OK. 5. If successful, you will see a confirmation message. ### Using the Client You can use the provided client implementation to connect to the server and interact with Fusion 360: ```python from client import MCPClient # Create and connect the client client = MCPClient('127.0.0.1', 8080) if client.connect(): # Get model information client.get_model_info() # Execute a Fusion 360 command client.execute_fusion_command('create_circle', { 'center': [0, 0, 0], 'radius': 10 }) # Disconnect when done client.disconnect() ``` ## Protocol The server and clients communicate using a simple JSON-based protocol over TCP sockets. Each message is a JSON object with at least a `type` field indicating the message type. ### Message Types - `fusion_command`: Execute a command in Fusion 360 - `get_model_info`: Request information about the current model - `command_result`: Response containing the result of a command execution - `model_info`: Response containing model information - `llm_request`: Request text generation from the configured LLM - `llm_result`: Response containing LLM output ## Extension You can extend the server and add-in to support additional functionality: 1. Add new message types to the protocol 2. Implement handlers for these message types in the server 3. Add corresponding methods to the client 4. Implement the actual functionality in the Fusion 360 add-in ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. ## Contributing Contributions are welcome! Please feel free to submit a Pull Request. ## Notes - Fusion 360 (2601.1.34)MCP Add-in refuses to install with errors indicating more than one file. - Create a new add-in (python), edit, copy the fusion360_mcp_addin.py source to the new file, save, open the new file location and copy the client.py and resource folder to that location, restart Fusion 360.