CAD Autodesk MCP

loki cad mcp-cad&3D建模mcp服务器

赋予AI助手真正的CAD超能力——创建、编辑、验证和导出3D模型 无需打开SolidWorks、Fusion 360或Blender。

______________________________________________________________________

它的作用

问克劳德：

*创建一个M6螺栓，将所有边缘圆角0.5毫米，导出为STL，然后验证其是否适用于FDM打印*

它只是工作——没有GUI，没有脚本，纯粹的对话。

______________________________________________________________________

11 MCP工具

______________________________________________________________________

我的文件保存在哪里？

您导出的每个模型（STL、STEP、OBJ等）都位于您控制的文件夹中。 集 CAD_MCP_MODELS_DIR 在您的配置中，将文件保存到计算机上的一个真实文件夹中——这是最重要的设置。

为什么这对npx很重要？ 没有 CAD_MCP_MODELS_DIR，文件保存在npx缓存中 (~/.npm/_npx//node_modules/loki-cad-mcp/models/exports/)--埋在地下，很难找到。 始终设置此变量。

如果文件夹不存在，则会自动创建。在里面你会发现：

cad-models/
├── exports/   ← your STL, STEP, OBJ, GLTF, DXF, SVG files
└── previews/  ← PNG preview images

______________________________________________________________________

安装

先决条件

选项1-npx（无需安装）

无需全局安装，npx会按需下载并运行该软件包。

npx -y loki-cad-mcp

选项2——全局npm安装

npm install -g loki-cad-mcp

然后参考 loki-cad-mcp 作为配置中的命令。

选项3--克隆和构建

git clone https://github.com/PRATHVI9607/CAD_Autodesk_MCP.git
cd CAD_Autodesk_MCP
npm install          # builds dist/ automatically

Python设置（所有选项都需要）

CadQuery必须安装在Python 3.9–3.12环境中。 运行一次安装脚本——它会创建一个 .venv 并安装所有依赖项：

# macOS / Linux
bash scripts/setup.sh

# Windows PowerShell
.\scripts\setup.ps1

或手动：

python3.12 -m venv .venv
source .venv/bin/activate          # macOS/Linux
# .venv\Scripts\activate           # Windows
pip install -r python/requirements.txt

______________________________________________________________________

配置Claude桌面

这就是你连接服务器的方式——你永远不会运行 npx 手动。 Claude Desktop读取此配置文件并自动启动服务器。

步骤1--打开配置文件

在任何文本编辑器（记事本、VS Code等）中打开它。如果它还不存在，就创建它。

步骤2——粘贴平台的配置

Windows--npx

{
  "mcpServers": {
    "loki-cad-mcp": {
      "command": "npx",
      "args": ["-y", "loki-cad-mcp"],
      "env": {
        "CAD_MCP_MODELS_DIR": "C:/Users/YourName/Documents/cad-models",
        "CAD_MCP_PYTHON_CMD": "python"
      }
    }
  }
}

macOS--npx

{
  "mcpServers": {
    "loki-cad-mcp": {
      "command": "npx",
      "args": ["-y", "loki-cad-mcp"],
      "env": {
        "CAD_MCP_MODELS_DIR": "/Users/yourname/Documents/cad-models",
        "CAD_MCP_PYTHON_CMD": "python3"
      }
    }
  }
}

Linux--npx

{
  "mcpServers": {
    "loki-cad-mcp": {
      "command": "npx",
      "args": ["-y", "loki-cad-mcp"],
      "env": {
        "CAD_MCP_MODELS_DIR": "/home/yourname/cad-models",
        "CAD_MCP_PYTHON_CMD": "python3"
      }
    }
  }
}

替换 YourName / yourname 使用您的实际用户名。 文件夹(cad-models)它是自动创建的，您不需要自己创建。

步骤3--重新启动克劳德桌面

关闭并重新打开Claude Desktop。服务器在第一次工具调用时自动启动。

您导出的文件将显示在：

• 窗户： C:\Users\YourName\Documents\cad-models\exports\
• macOS/Linux： ~/Documents/cad-models/exports/

______________________________________________________________________

克隆的repo配置（如果您克隆而不是使用npx）

视窗

{
  "mcpServers": {
    "loki-cad-mcp": {
      "command": "node",
      "args": ["C:/path/to/CAD_Autodesk_MCP/dist/index.js"],
      "env": {
        "CAD_MCP_MODELS_DIR": "C:/Users/YourName/Documents/cad-models",
        "CAD_MCP_PYTHON_CMD": "C:/path/to/CAD_Autodesk_MCP/.venv/Scripts/python.exe"
      }
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "loki-cad-mcp": {
      "command": "node",
      "args": ["/path/to/CAD_Autodesk_MCP/dist/index.js"],
      "env": {
        "CAD_MCP_MODELS_DIR": "/Users/yourname/Documents/cad-models",
        "CAD_MCP_PYTHON_CMD": "/path/to/CAD_Autodesk_MCP/.venv/bin/python"
      }
    }
  }
}

______________________________________________________________________

环境变量

______________________________________________________________________

建筑

MCP Client (Claude Desktop / Claude Code / Cursor / etc.)
    │  stdio transport — MCP protocol (JSON-RPC 2.0)
    ▼
dist/index.js              — 11 tools, Zod validation, StdioServerTransport
dist/http-server.js        — optional REST wrapper on port 3000 (testing)
    │  JSON-RPC 2.0 over subprocess stdin/stdout
    ▼
python/cadquery_server.py  — persistent geometry server
    ├─ CadQuery / OpenCASCADE  (parametric BRep modelling)
    ├─ trimesh                 (mesh validation, repair, OBJ/GLTF export)
    └─ validators.py           (3D-printability checks)
    ▼
CAD_MCP_MODELS_DIR/exports/    (STL, STEP, OBJ, GLTF, DXF, SVG)
CAD_MCP_MODELS_DIR/previews/   (PNG previews)

______________________________________________________________________

发展

# Clone & install
git clone https://github.com/PRATHVI9607/CAD_Autodesk_MCP.git
cd cad-mcp
npm install

# Set up Python
.\scripts\setup.ps1   # Windows
bash scripts/setup.sh # macOS/Linux

# Type-check
npm run typecheck

# Build
npm run build

# Start HTTP test server (port 3000)
npm run start:http

# Run integration tests
npm run test:http

______________________________________________________________________

安全

• 所有输出文件严格限于 CAD_MCP_MODELS_DIR --路径遍历被拒绝
• 根据验证模型名称 /^[A-Za-z0-9_\-]{1,128}$/
• 在到达CAD内核之前，拒绝负/零尺寸
• 几何操作在30秒后超时；60秒后渲染
• 根据shell注入字符验证Python可执行路径
• 没有向MCP客户端公开原始Python堆栈跟踪
• HTTP测试服务器绑定到 localhost 只是——不要暴露在网络中

______________________________________________________________________

模板

9个参数化模板可供使用：

# In Claude:
"Load the bolt_m6 template with shank_length=40 and export to STL."

______________________________________________________________________

许可证

麻省理工学院——见 许可证.