Openscad MCP

OpenSCAD MCP服务器

OpenSCAD的模型上下文协议（MCP）服务器使AI助手能够创建和操作3D CAD模型。

特性

• 渲染：将OpenSCAD代码编译为3D网格格式（STL、OFF、AMF、3MF、CSG）
• 预览：使用相机控件生成2D预览（PNG、SVG、DXF、PDF）
• 验证：检查OpenSCAD语法而不生成输出
• 信息：获取OpenSCAD安装信息

先决条件

• Node.js 18或更高版本
• OpenSCAD 安装在您的系统上

安装

通过npm（推荐）

npm install -g openscad-mcp

源自源头

# Clone the repository
git clone https://github.com/dkpoulsen/openscad-mcp.git
cd openscad-mcp

# Install dependencies and build
npm install
npm run build

使用Claude Desktop

添加到您的Claude Desktop配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

使用npx（安装npm后）

{
  "mcpServers": {
    "openscad": {
      "command": "npx",
      "args": ["-y", "openscad-mcp"]
    }
  }
}

使用本地构建

{
  "mcpServers": {
    "openscad": {
      "command": "node",
      "args": ["/path/to/openscad-mcp/dist/index.js"]
    }
  }
}

工具

渲染

将OpenSCAD代码编译为3D网格格式。

参数：

• scad （字符串，必填）：要编译的OpenSCAD代码
• format （字符串，默认值：“stl”）：输出格式- stl, off, amf, 3mf，或 csg
• parameters （object，可选）：要传递的变量-D标志
• exportFormat （字符串，可选）：用于STL- asciistl 或 binstl
• hardwarnings （boolean，默认值：true）：将警告视为错误

预览

生成二维预览或矢量导出。

参数：

• scad （字符串，必填）：要预览的OpenSCAD代码
• format （字符串，默认值：“png”）：输出格式- png, svg, dxf，或 pdf
• width （数字，默认值：800）：图像宽度（像素）
• height （数字，默认值：600）：图像高度（像素）
• camera （字符串，可选）：摄像头位置
• colorscheme （字符串，默认值：“Cornfield”）：配色方案
• projection （字符串，默认值：“透视图”）： ortho 或 perspective
• autocenter （boolean，默认值：true）：将设计居中
• viewall （boolean，默认值：true）：在视图中适应整个设计
• render （boolean，默认值：false）：使用完整的CGAL渲染

验证

验证OpenSCAD语法。

参数：

• scad （字符串，必填）：要验证的OpenSCAD代码
• parameters （对象，可选）：要定义的变量

信息

获取OpenSCAD安装信息。

AI助手使用示例

User: Create a simple 10x10x10 cube in OpenSCAD and render it to STL

AI: I'll create a cube and render it for you.

[Uses render tool with:]
scad: cube([10, 10, 10]);
format: stl

配色方案

PNG导出的可用配色方案：

• 玉米田（默认）
• 金属的
• 日落
• 斯达耐
• 黎明前
• 自然
• 日光宝石
• 夜行宝石
• 深海
• 日光化
• 明天
• 明晚
• ClearSky
• 单调

许可证

麻省理工学院