Skip to main content
Glama
MAvinash24

Autodesk CAD MCP & RAG Assistant

by MAvinash24
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
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.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Fusion360 MCP Server

    faust-machines
    A
    license
    B
    quality
    D
    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
    85
    MIT

  • Fusion MCP para Codex

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

  • fusion-spatial-mcp

    aphollis
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that gives AI agents genuine 3D spatial understanding of Autodesk Fusion 360, enabling exact measurements, collision analysis, and free-space placement search, plus Fusion-native parametric authoring for clean, human-editable models.
    MIT

  • AEC Model Bridge

    Sam-AEC
    A
    license
    Not graded
    quality
    A
    maintenance
    Open, secure runtime that puts Revit, Rhino, Navisworks, and Power BI behind one MCP call center, enabling an AI agent to orchestrate them directly instead of manually dumping data between disconnected apps.
    60
    GPL 3.0