OpenSCAD MCP Server

🚀 OpenSCAD 3D建模服务器

OpenSCAD 3D建模服务器是一个开源平台，支持从文本生成高质量3D模型。该系统集成了图像生成、多视图处理、3D重建和远程计算等多种功能模块。

🚀 快速开始

环境要求

• 操作系统: Linux (推荐) 或 Windows（仅UI）
• 内存: 至少4GB RAM
• 显卡: 支持CUDA加速（可选）

安装步骤

git clone https://github.com/openscad-server/main.git
cd main
pip install requirements.txt

启动服务

python openscad_server.py --port=8000

✨ 主要特性

• AI驱动图像生成：支持Google Gemini和Venice.ai两种图像生成服务。
• 多视图工作流：实现从图像生成到3D模型构建的完整流程。
• OpenSCAD集成：提供参数化建模能力和设计优化功能。
• 远程计算支持：可扩展至高性能服务器进行3D重建。
• 网络打印机兼容性：支持直接连接和控制3D打印机。

📦 安装指南

环境要求

• 操作系统: Linux (推荐) 或 Windows（仅UI）
• 内存: 至少4GB RAM
• 显卡: 支持CUDA加速（可选）

安装步骤

git clone https://github.com/openscad-server/main.git
cd main
pip install requirements.txt

启动服务

python openscad_server.py --port=8000

💻 使用示例

常用命令示例

生成图片

{
"prompt": "一只可爱的兔子",
"num_views": 4,
"model": "gemini-2.0-flash-exp-image-generation"
}

创建3D模型

{
"image_ids": ["view1", "view2", "view3", "view4"],
"output_name": "兔子模型"
}

导出模型文件

{
"model_id": "rabbit_model",
"format": "STL"
}

📚 详细文档

功能模块

1. 图像生成器

• Google Gemini API：默认使用Gemini 2.0 Flash Experimental模型。
• Venice.ai API：支持多种图像生成模型（需额外密钥）。
• 用户自定义图像：允许上传现有图片进行建模。

2. 多视图处理流程

1. 图像生成：根据输入文本生成多角度视图。
2. 图像审核：提供在线界面用于查看和确认图像。
3. 3D重建：使用CUDA MVS技术从批准的图像构建模型。
4. 模型优化：支持OpenSCAD进行参数化调整。

3. 远程计算工作流

1. 服务器发现：自动识别网络中的计算节点。
2. 任务分发：将处理请求发送至空闲服务器。
3. 状态监控：提供实时进度和资源使用情况。
4. 结果下载：支持模型文件的远程获取。

4. 模型导出格式

• OBJ：波front标准格式
• STL：标准三角形语言
• PLY：多边形文件格式
• SCAD：OpenSCAD源代码
• CSG：参数化建模数据
• AMF：加工制造规范格式
• 3MF：现代制造标准

5. 网络接口

• UI界面：提供图形化操作面板（访问地址：http://localhost:8000/ui/）
• REST API：支持程序matic操作
• WebSocket：实时状态更新和事件监听

🔧 技术细节

1. 图像生成模块

• 基于扩散模型进行图像合成。
• 支持多种画质和风格选项。
• 提供实时预览功能。

2. 3D重建算法

• 使用CUDA加速的MVS技术。
• 高精度点云处理。
• 自动网格化输出。

3. 网络架构

• 基于微服务设计。
• 支持水平扩展。
• 提供负载均衡能力。

📄 许可证

本项目遵循MIT License协议，具体内容请参见LICENSE文件。

开发与贡献部分：欢迎任何开发者参与项目开发！请参考Contributing Guide了解如何贡献代码。