Skip to main content
Glama
Sign In
Autodesk CAD MCP & RAG Assistant

Autodesk CAD MCP & RAG Assistant

by MAvinash24
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Autodesk CAD MCP & RAG Assistant 🚀

CI Pipeline License: MIT C++ Python Protocol FastAPI

An enterprise-grade agentic microservice bridging high-speed C++ 3D geometry evaluation with Python (FastAPI), Anthropic's Model Context Protocol (MCP), and a RAG (Retrieval-Augmented Generation) knowledge engine grounded on Autodesk APIs (Fusion 360, APS / Forge, Revit, and Inventor).

🌟 Key Highlights

  • Model Context Protocol (MCP) JSON-RPC 2.0: Full compliance with the Anthropic open standard, enabling autonomous agents (Claude Desktop, local LLMs) to discover tools via tools/list and invoke CAD calculations via tools/call.

  • Native C++ Geometry Core: Offloads compute-heavy 3D mesh evaluation (bounding volumes, surface areas, and extents) to a compiled C++17 shared library (geometry.dll / libgeometry.so) via zero-overhead ctypes.

  • Zero-Crash Resilience: Built-in high-performance pure-Python fallback path ensures uninterrupted service even when dynamic libraries are unavailable.

  • Autodesk Domain RAG Index: In-memory semantic vector and keyword retrieval grounding LLMs on official Autodesk APIs (Fusion 360 ExtrudeFeature, APS Model Derivative, Revit BoundingBoxXYZ, Inventor MassProperties), eliminating hallucinations.

  • Dual Interface: Exposes standardized MCP JSON-RPC (/mcp) and interactive OpenAPI/Swagger REST endpoints (/api/v1/...).

  • Production SDLC: 100% test coverage with pytest, parameterized parity checks between C++ and Python engines, and a multi-OS GitHub Actions CI/CD matrix.

Related MCP server: Fusion MCP para Codex

📐 System Architecture

                       +-----------------------------------+
                       |      AI Host / Autonomous Agent   |
                       |    (Claude Desktop / Cursor / LLM)|
                       +-----------------------------------+
                                         |
                                         | JSON-RPC 2.0 (MCP Protocol)
                                         v
+-----------------------------------------------------------------------------------+
|                        FastAPI Microservice (server/main.py)                      |
|                                                                                   |
|  [ Endpoint: /mcp ]                [ Endpoint: /api/v1/geometry ]                 |
|  MCP Protocol router               Direct REST CAD calculations                   |
|                                                                                   |
|  [ Endpoint: /api/v1/rag ]         [ Endpoint: / ]                                |
|  Vector documentation search       Health check & C++ engine telemetry            |
+-----------------------------------------------------------------------------------+
               |                                                   |
               |                                                   |
               v                                                   v
+-----------------------------+                 +-----------------------------------+
|   Semantic RAG Engine       |                 |     Native C++ Geometry Bridge    |
|   (server/rag_engine.py)    |                 |        (server/mcp_tools.py)      |
|                             |                 |                                   |
|  - Tokenization & Scoring   |                 |  ctypes Foreign Function Interface|
|  - Autodesk API Knowledge   |                 +-----------------------------------+
|    (Fusion, APS, Revit)     |                                   |
+-----------------------------+                                   v
               |                                +-----------------------------------+
               v                                |    Compiled C++ Geometry Core     |
      data/autodesk_docs.json                   |     (core/geometry_engine.cpp)    |
                                                |                                   |
                                                |  - SIMD / O3 Optimized Loops     |
                                                |  - Bounding Volume & Surface Area |
                                                |  - Extents & Centroid Math        |
                                                +-----------------------------------+

📂 Repository Structure

autodesk-cad-mcp-agent/
│
├── core/
│   ├── geometry_engine.cpp       # High-speed C++ geometry evaluation core
│   └── CMakeLists.txt            # CMake build configuration for shared library
│
├── server/
│   ├── __init__.py               # Python package initialization
│   ├── main.py                   # FastAPI REST & MCP JSON-RPC 2.0 Server
│   ├── rag_engine.py             # Semantic RAG retrieval engine
│   └── mcp_tools.py              # MCP tool definitions & C++ ctypes bridge
│
├── tests/
│   ├── __init__.py               # Tests package initialization
│   ├── test_geometry.py          # Pytest suite for geometry math & parity
│   └── test_mcp_api.py           # Pytest suite for REST & MCP endpoints
│
├── data/
│   └── autodesk_docs.json        # Autodesk API & CAD engineering knowledge base
│
├── scripts/
│   └── build.bat                 # 1-click Windows compilation script (MSVC/g++)
│
├── .github/
│   └── workflows/ci.yml          # Multi-OS GitHub Actions CI/CD matrix
│
├── requirements.txt              # Production and test Python dependencies
├── Makefile                      # Cross-platform build automation
├── .gitignore                    # Git ignore configuration
└── README.md                     # Comprehensive project documentation

⚡ Quickstart Guide

Prerequisites

  • Python: Version 3.10 or higher

  • C++ Compiler:

    • Windows: MSVC 2019/2022 (Build Tools) or MinGW g++

    • Linux: g++ (GCC 9+)

    • macOS: clang++ (Apple Clang)

Step 1: Clone Repository

git clone https://github.com/MAvinash24/autodesk-cad-mcp-agent.git
cd autodesk-cad-mcp-agent

Step 2: Install Python Dependencies

pip install -r requirements.txt

Step 3: Compile the C++ Engine

On Windows:

Run the included 1-click build batch script (automatically detects MSVC cl or g++):

scripts\build.bat

Or manual MSVC compile:

cl /O2 /LD /EHsc core\geometry_engine.cpp /Fe:geometry.dll

On Linux:

g++ -O3 -shared -fPIC -o libgeometry.so core/geometry_engine.cpp

On macOS:

clang++ -O3 -shared -fPIC -o libgeometry.dylib core/geometry_engine.cpp

Step 4: Run the Microservice

python server/main.py

The server will bind to http://127.0.0.1:8000.

🧪 Running Automated Tests

Run the full test suite with verbose reporting:

pytest tests/ -v

Test Coverage Summary:

  • test_geometry.py: Validates unit cubes, bounding extents, empty arrays, degenerate single-point inputs, and strict parity between native C++ and pure-Python execution paths.

  • test_mcp_api.py: Validates health telemetry, REST endpoints, MCP initialize, ping, tools/list, tools/call, and standardized JSON-RPC error codes (-32601, -32602).

🔌 Connecting to Claude Desktop / MCP Clients

To use this CAD assistant inside Claude Desktop, add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "autodesk-cad-agent": {
      "command": "python",
      "args": ["-m", "server.main"]
    }
  }
}

Once connected, Claude can autonomously reason:

"Claude, analyze this 3D bracket mesh with vertices [0,0,0, 10,5,2] and find the Fusion 360 API class to extrude it."

Claude will:

  1. Invoke calculate_cad_mesh_metrics via MCP to compute exact volume and surface area.

  2. Invoke search_autodesk_api_knowledge to retrieve the ExtrudeFeatureInput specification.

  3. Return synthesized, hallucination-free CAD automation code.

📡 API Reference & Usage Examples

1. Health Check & Engine Telemetry

GET /

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

Response:

{
  "status": "healthy",
  "service": "Autodesk CAD MCP + RAG Assistant",
  "version": "1.0.0",
  "geometry_engine": {
    "is_native_cpp": true,
    "engine_mode": "c++_native",
    "library_path": "C:\\...\\geometry.dll"
  },
  "knowledge_base_count": 6,
  "supported_protocols": ["MCP JSON-RPC 2.0", "REST / HTTP"]
}

2. High-Speed Geometry Calculation (REST)

POST /api/v1/geometry/calculate

curl -X POST http://127.0.0.1:8000/api/v1/geometry/calculate \
  -H "Content-Type: application/json" \
  -d '{"vertices": [0.0, 0.0, 0.0, 10.0, 5.0, 2.0]}'

Response:

{
  "status": "success",
  "metrics": {
    "bounding_volume": 100.0,
    "surface_area": 160.0,
    "vertex_count": 2,
    "engine": "c++_native"
  }
}

3. Autodesk API RAG Retrieval (REST)

GET /api/v1/rag/search?query=extrude+fusion+volume

curl -X GET "http://127.0.0.1:8000/api/v1/rag/search?query=extrude+fusion+volume&top_k=2"

Response:

{
  "query": "extrude fusion volume",
  "count": 2,
  "documents": [
    {
      "id": "doc-01",
      "title": "Autodesk Fusion 360 API - ExtrudeFeature & Bounding Calculation",
      "text": "The ExtrudeFeatureInput class in the Autodesk Fusion 360 API allows programmatic generation of solid bodies...",
      "relevance_score": 0.5833,
      "matched_keywords": ["extrude", "fusion", "volume"]
    }
  ]
}

4. Model Context Protocol: tools/list (JSON-RPC 2.0)

POST /mcp

curl -X POST http://127.0.0.1:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

5. Model Context Protocol: tools/call (JSON-RPC 2.0)

POST /mcp

curl -X POST http://127.0.0.1:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "calculate_cad_mesh_metrics",
      "arguments": {
        "vertices": [0.0, 0.0, 0.0, 2.0, 2.0, 2.0]
      }
    }
  }'

Response:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"bounding_volume\": 8.0, \"surface_area\": 24.0, \"vertex_count\": 2, \"engine\": \"c++_native\"}"
      }
    ]
  },
  "error": null
}

📜 License

This project is open-source and licensed under the MIT License.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Fusion360 MCP Server

      faust-machines
      A
      license
      B
      quality
      C
      maintenance
      Connects AI coding agents to Autodesk Fusion 360 for CAD automation, enabling natural language control over sketching, 3D modeling, and CAM operations. It uses a Python-based bridge and a custom add-in to execute over 80 tools ranging from simple geometry creation to complex assembly and parameter management.
      80
      483 PyPI
      147
      MIT

    • Fusion MCP para Codex

      ffelipev2
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to inspect and automate Autodesk Fusion 360 through MCP, providing tools for CAD modeling, CAM manufacturing, and document management.
      -

    • io.github.bcllcc/modulor

      bcllcc
      A
      license
      Not graded
      quality
      D
      maintenance
      Agent-native 2D drafting and 3D modeling kernel with a JSON op protocol, enabling parametric design, BIM semantics, and MCP server access for geometry generation and verification.
      3
      MIT

    • CadKitty

      BeeJay805
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to build and edit native CAD parts and assemblies, inspect saved geometry and measurements, retain revisions, run mechanism and interference checks, and export STEP/STL/GLB artifacts through MCP tools.
      MIT