AI导哈

OpenSCAD模型协议服务器

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

  • by trikos529
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 trikos529/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

  2. 创建或编辑 custom.yaml:

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

  3. 将此条目添加到 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

  2. 在现有条目下添加此条目 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

  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 使用您实际的主目录路径。

步骤6：重启Claude桌面程序

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

步骤7：测试您的服务器

docker mcp server list

示例查询

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

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

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

相关 MCP