OpenSCAD渲染服务

提供OpenSCAD代码渲染、STL文件生成和文档资源的服务器服务。

  • by format37
  • Python
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 format37/openscad-mcp

使用说明

OpenSCAD MCP

Openscad MCP服务器,具备以下功能:

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

演示视频

观看OpenSCAD MCP的实际操作:

客户端安装

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

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

提供的URL仅为演示之用,最终将会被移除。

服务器安装

要求

  • “donaim name”可以翻译为“天之名”或“上天之名”,具体翻译可能根据上下文和语境有所调整。在这里,“donaim”通常与犹太教或某些宗教传统中的神圣名称相关,而“name”则直接翻译为“名”。因此,“donaim name”可以理解为对某种神圣或至高无上之名的称呼
  • 带有外部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

并发性与持久性

  • 服务器限制同时进行的OpenSCAD渲染数量 RENDER_MAX_CONCURRENCY (默认值:2)。在小型主机上谨慎增加。
  • 每个渲染结果都保存在 ./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/"
        ]
    }
  }
}