OpenSCAD MCP Server

一个全面的模型上下文协议（MCP）服务器，提供深入的OpenSCAD知识和安全的文件管理功能，适用于3D建模工作流程。

目的

此服务器作为OpenSCAD的专家参考和项目助手，为AI助手提供权威的OpenSCAD文档和安全的文件操作，以加速3D设计工作流程。

特性

全面的OpenSCAD知识

• get_scad_syntax() - 完整的语言语法、规则和流程控制
• get_scad_reference(category) - 按类别详细参考：
  • syntax - 语言特性和结构
  • primitives - 2D和3D基本形状
  • operations - CSG操作和变换
  • variables - 特殊变量和调试修饰符
  • bestpractices - 设计模式和优化
• scad_quick_help(topic) - 常用操作的快速函数参考

安装

预备条件

• 已安装并运行Docker。

第一步：保存文件

创建一个新的项目目录，并在其中保存以下文件：

• Dockerfile
• requirements.txt
• openscad_server.py
• readme.md
• LLM_GUIDE.md

第二步：构建Docker镜像

docker build -t openscad-mcp-server .

第三步：为Claude Desktop创建自定义目录

1. 如果不存在，请创建目录：

   mkdir -p ~/.docker/mcp/catalogs
   

2. 创建或编辑 custom.yaml：

   nano ~/.docker/mcp/catalogs/custom.yaml
   

3. 在 custom.yaml 中添加以下条目：

   version: 2
   name: custom
   displayName: 自定义MCP服务器
   registry:
     openscad:
       description: "全面的OpenSCAD知识库和3D建模文件管理"
       title: "OpenSCAD助手"
       type: server
       dateAdded: "2025-01-15T00:00:00Z"
       image: openscad-mcp-server:latest
       ref: ""
       readme: ""
       toolsUrl: ""
       source: ""
       upstream: ""
       icon: ""
       tools:
         - name: get_scad_syntax
         - name: get_scad_reference
         - name: scad_quick_help
       secrets: []
       metadata:
         category: 生产力
         tags:
           - openscad
           - 3d建模
           - cad
           - 3d打印
         license: MIT
         owner: local
   

第四步：更新Claude Desktop的注册表

1. 编辑注册表文件：

   nano ~/.docker/mcp/registry.yaml
   

2. 在现有的 registry: 键下添加以下条目：

   registry:
     # ... 现有的服务器 ...
     openscad:
       ref: ""
   

第五步：配置Claude Desktop

1. 找到你的Claude Desktop配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 编辑文件，并将自定义目录添加到 args 数组中：

   {
     "mcpServers": {
       "mcp-toolkit-gateway": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-v", "/var/run/docker.sock:/var/run/docker.sock",
           "-v", "C:/Users/your_username/.docker/mcp:/mcp",
           "docker/mcp-gateway",
           "--catalog=/mcp/catalogs/docker-mcp.yaml",
           "--catalog=/mcp/catalogs/custom.yaml",
           "--config=/mcp/config.yaml",
           "--registry=/mcp/registry.yaml",
           "--tools-config=/mcp/tools.yaml",
           "--transport=stdio"
         ]
       }
     }
   }
   

   重要提示： 将 /Users/your_username 替换为你实际的主目录路径。

第六步：重启Claude Desktop

1. 完全退出Claude Desktop。
2. 再次启动Claude Desktop。
3. 你的OpenSCAD工具现在应该可用。

第七步：测试你的服务器

docker mcp server list

示例查询

安装后，你可以向Claude询问：

• "展示给我OpenSCAD的语法规则"
• "有哪些可用于变换的操作？"
• "创建一个新的SCAD文件用于参数化盒子"
• "读取我的现有project.scad文件并提出改进建议"
• "如何使用hull()操作？"

此服务器将AI助手转变为具有即时访问全面3D建模知识的OpenSCAD专家顾问。