Jhacksman OpenSCAD MCP Server

🚀 OpenSCAD 3D 模型生成服务器

本项目是一个 3D 模型生成服务器，支持多种图像生成 API，可进行多视图处理和 3D 模型重建，还能导出多种 3D 文件格式，为 3D 模型的创建提供了便捷的解决方案。

🚀 快速开始

本服务器可帮助你快速生成和处理 3D 模型，以下是使用前的安装和基本使用说明。

📦 安装指南

安装要求

• 操作系统：支持 Linux 或 Windows（推荐使用 Ubuntu 20.04+）
• Python 版本：Python 3.8+
• 依赖库：OpenCV、Flask、requests、jsonschema、numpy、open3d
• CUDA 支持：CUDA 11+，用于加速 3D 模型重建

安装步骤

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

✨ 主要特性

• 图像生成：支持 Gemini 和 Venice.ai API，可自定义视角数量和风格。
• 多视图处理：通过 Web 界面审批和管理多视图图像。
• 3D 模型重建：利用 CUDA MVS 技术进行模型重建，支持本地与远程服务器计算。
• 格式导出：支持 OBJ、STL、PLY、SCAD 等多种 3D 文件格式。

💻 使用示例

基础用法

图像生成

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

多视图重建

{
    "image_ids": ["view_1.jpg", "view_2.jpg", "view_3.jpg", "view_4.jpg"],
    "output_name": "兔子模型"
}

📚 详细文档

功能选项

图像生成选择

1. Google Gemini API（默认）：采用 Gemini 2.0 Flash Experimental 模型，提供高质量图像。

   • 支持多视图风格一致生成，需配置 Google API Key。

2. Venice.ai API（可选）：支持 flux-dev 和 fluently-xl 等多种模型。

   • 需配置 Venice.ai API Key。

3. 自定义图像：上传本地图片，适用于已有照片或渲染图。

多视图工作流

1. 生成多视角图像
2. 审批通过的图像
3. 转换为 3D 模型（支持本地与远程 CUDA MVS）
4. 可选 OpenSCAD 进行模型优化

远程处理流程

1. 发现网络中的 CUDA MVS 服务器
2. 上传审批后的多视图图像到远程服务器
3. 提交作业并追踪进度
4. 下载完成的 3D 模型

支持导出格式

• OBJ：波front 对象文件（标准 3D 模型）
• STL：标准三角形语言（适合 3D 打印）
• PLY：多边形文件格式
• SCAD：OpenSCAD 源代码
• CSG：OpenSCAD CSG 格式（保留所有参数属性）
• AMF：增材制造文件格式
• 3MF：3D 制造格式（现代 STL 替代品）

Web 界面

访问地址：http://localhost:8000/ui/

功能包括：

• 生成与审批多视图图像
• 预览 3D 模型（支持旋转缩放）
• 管理 API 密钥和服务器配置
• 查看历史作业记录

📄 许可证

本项目遵循 MIT 协议，代码仓库地址：OpenSCAD 服务端

🤝 贡献指南

欢迎提交 PR 或 ISSUE：

• 提交问题请包含日志文件和详细描述
• PR 前需通过单元测试
• Fork 仓库并基于 main 分支开发