Scad MCP V2

OpenSCAD MCP 服务器

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

目的

这台服务器扮演着OpenSCAD专家参考和项目助手的角色，为AI助手提供权威的OpenSCAD文档和安全的文件操作功能，以加速3D设计工作流程。

特点/特性

全面掌握OpenSCAD知识

• get_scad_syntax() - 完整的语言语法、规则和流程控制
• get_scad_reference(category) - 按类别详细参考：

- syntax - 语言特征和结构 - primitives - 二维和三维基本形状 - operations - CSG（构造实体几何）操作和变换 - variables - 特殊变量和调试修饰符 - bestpractices - 设计模式与优化

• scad_quick_help(topic) - 常见操作的快速功能参考

安装

先决条件

• Docker 已安装并正在运行。

第一步：保存文件

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

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

步骤2：构建Docker镜像

docker build -t openscad-mcp-server .

步骤3：为Claude桌面创建自定义目录

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

   mkdir -p ~/.docker/mcp/catalogs

1. 创建或编辑 custom.yaml:

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

1. 将此条目添加到 custom.yaml:

   version: 2
   name: custom
   displayName: Custom MCP Servers
   registry:
     openscad:
       description: "Comprehensive OpenSCAD knowledge base and file management for 3D modeling"
       title: "OpenSCAD Assistant"
       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: productivity
         tags:
           - openscad
           - 3d-modeling
           - cad
           - 3d-printing
         license: MIT
         owner: local

步骤4：更新Claude桌面版的注册表

1. 编辑注册表文件：

   nano ~/.docker/mcp/registry.yaml

1. 在现有条目下添加此条目 registry: 关键词：

   registry:
     # ... existing servers ...
     openscad:
       ref: ""

第五步：配置Claude桌面版

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

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

1. 编辑该文件，并将您的自定义目录添加到其中 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 使用您实际的主目录路径。

步骤6：重启Claude桌面程序

1. 彻底退出Claude Desktop。
2. 重新启动Claude桌面版。
3. 您的OpenSCAD工具现在应该已经可以使用了。

步骤7：测试您的服务器

docker mcp server list

示例查询

安装完成后，您可以向Claude提问：

• “给我看看OpenSCAD的语法规则”
• “有哪些可用的转换功能？”
• “为参数化盒子创建一个新的SCAD文件”
• “阅读我的现有项目.scad文件并提出改进建议”
• “我该如何使用 hull() 操作？”

这台服务器将人工智能助手转变为专业的OpenSCAD顾问，使其能够即时获取全面的3D建模知识。