OpenSCAD MCP

OpenSCAD MCP服务器具有以下功能：

• 将OpenSCAD代码渲染成PNG图像
• 从OpenSCAD代码生成STL文件
• 提供OpenSCAD文档资源

演示视频

观看OpenSCAD MCP的实际操作：

客户端安装

可在Claude网页版、Claude移动版、Chat GPT网页版以及其他任何MCP客户端中使用：

https://scriptlab.duckdns.org/openscad/8TikTAffQT3Db65Q7xbofbUjapGjKepTI3sikOeLWClfXW5GXO/

提供的URL仅用于演示，最终会被移除。

服务器安装

需求

• 域名
• 具有外部IP地址的Linux机器
• 足够的防火墙端口配置

1. 反向代理

安装这个或使用您自己的。

2. Git克隆

git clone https://github.com/format37/openscad-mcp.git
cd openscad-mcp

3. 环境变量

本地主机

cd mcp
nano .env.production

生成任意令牌。 定义：用逗号分隔的令牌：

MCP_TOKENS=YOUR_TOKEN
MCP_REQUIRE_AUTH=true
MCP_ALLOW_URL_TOKENS=true

检查docker-compose.yml是否根据您的DNS名称进行了相应配置。

4. 组合

./production.sh

并发与持久化

• 服务器通过RENDER_MAX_CONCURRENCY（默认值：2）限制同时进行的OpenSCAD渲染。在小型主机上需谨慎增加此值。
• 每次渲染结果保存在./data/scad/<uid>/和./data/render/<uid>/目录下，文件名由提供的filename加上视图（例如：script_3d.png）组成。如果您需要可预测的位置，可以传递自定义uid。

5. Claude桌面配置

该令牌仅临时用于演示，之后可能不可用。因此您可以部署自己的服务器：

{
  "mcpServers": {
      "openscad": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://rtlm.info/openscad/8TikTAffQT3Db65Q7xbofbUjapGjKepTI3sikOeLWClfXW5GXO/"
        ]
    }
  }
}