Fusion 360 MCP Server

A Model Context Protocol (MCP) server that interfaces between Cline and Autodesk Fusion 360. This server exposes Fusion 360 toolbar-level commands as callable tools that map directly to Fusion's API.

🧠 Overview

This project allows Cline to:

• Parse natural language prompts (e.g., "Make a box with rounded corners")
• Resolve them into Fusion tool actions (e.g., CreateSketch → DrawRectangle → Extrude → Fillet)
• Call those tools through this MCP server
• Return Python scripts that can be executed in Fusion 360

🛠️ Installation

Prerequisites

• Python 3.9 or higher
• Autodesk Fusion 360

Setup

1. Clone this repository:

   git clone https://github.com/yourusername/fusion360-mcp-server.git
   cd fusion360-mcp-server
   

2. Install dependencies:

   pip install -r requirements.txt
   

🚀 Usage

Running the HTTP Server

cd src
python main.py

This will start the FastAPI server at http://127.0.0.1:8000.

Running as an MCP Server

cd src
python main.py --mcp

This will start the server in MCP mode, reading from stdin and writing to stdout.

API Endpoints

• GET /: Check if the server is running
• GET /tools: List all available tools
• POST /call_tool: Call a single tool and generate a script
• POST /call_tools: Call multiple tools in sequence and generate a script

Example API Calls

List Tools

curl -X GET http://127.0.0.1:8000/tools

Call a Single Tool

curl -X POST http://127.0.0.1:8000/call_tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "CreateSketch",
    "parameters": {
      "plane": "xy"
    }
  }'

Call Multiple Tools

curl -X POST http://127.0.0.1:8000/call_tools \
  -H "Content-Type: application/json" \
  -d '{
    "tool_calls": [
      {
        "tool_name": "CreateSketch",
        "parameters": {
          "plane": "xy"
        }
      },
      {
        "tool_name": "DrawRectangle",
        "parameters": {
          "width": 10,
          "depth": 10
        }
      },
      {
        "tool_name": "Extrude",
        "parameters": {
          "height": 5
        }
      }
    ]
  }'

📦 Available Tools

The server currently supports the following Fusion 360 tools:

Create

• CreateSketch: Creates a new sketch on a specified plane
• DrawRectangle: Draws a rectangle in the active sketch
• DrawCircle: Draws a circle in the active sketch
• Extrude: Extrudes a profile into a 3D body
• Revolve: Revolves a profile around an axis

Modify

• Fillet: Adds a fillet to selected edges
• Chamfer: Adds a chamfer to selected edges
• Shell: Hollows out a solid body with a specified wall thickness
• Combine: Combines two bodies using boolean operations

Export

• ExportBody: Exports a body to a file

🔌 MCP Integration

To use this server with Cline, add it to your MCP settings configuration file:

{
  "mcpServers": {
    "fusion360": {
      "command": "python",
      "args": ["/path/to/fusion360-mcp-server/src/main.py", "--mcp"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

🧩 Tool Registry

Tools are defined in src/tool_registry.json. Each tool has:

• name: The name of the tool
• description: What the tool does
• parameters: The parameters the tool accepts
• docs: Link to relevant Fusion API documentation

Example tool definition:

{
  "name": "Extrude",
  "description": "Extrudes a profile into a 3D body.",
  "parameters": {
    "profile_index": {
      "type": "integer",
      "description": "Index of the profile to extrude.",
      "default": 0
    },
    "height": {
      "type": "number",
      "description": "Height of the extrusion in mm

... [View full README on GitHub](https://github.com/ArchimedesCrypto/fusion360-mcp-server#readme)