text-to-cad

gNucleus 文本转 CAD MCP 服务

gNucleus 是一个生成式 AI 平台，可将文本和图像转换为可编辑的 CAD 模型。

此仓库包含 gNucleus 文本转 CAD MCP 服务，可连接到 gNucleus API。它允许 MCP 客户端使用 gNucleus 的 GenAI 模型，根据文本输入生成 CAD 零件或装配体。

前提条件

• Python 3.7+
• gNucleus 开发者账户，需具备：
  • gNucleus API 密钥

设置

1. 克隆此仓库

2. 创建并激活虚拟环境（推荐）：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 安装依赖：

   pip install -r requirements.txt
   

4. 在根目录下创建 .env 文件，并添加以下变量：

   个人用户

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=<your-personal-api-key>
   

   企业用户

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=<your-team-key>
   GNUCLEUS_ORG_ID=<your-team-id>
   

获取 gNucleus API KEY

1. gNucleus 账户：在 https://gnucleus.ai/ 注册
2. API KEY：在 gNucleus 中创建个人访问令牌：
   • 前往用户个人资料（点击右上角的用户图标）
   • 前往“Account”
   • 点击“Generate New API Key”生成新的 API KEY
   • 每个账户初始可获得 200 个免费 API 点数

运行服务

启动 MCP 服务：

python main.py

运行以下命令，即可使用检查器测试 MCP 服务：

npx @modelcontextprotocol/inspector python3 main.py

可用的 MCP 工具

以下 MCP 工具可用：

• text_to_cad(input: str) - 根据输入生成 CAD

使用大模型的提示词示例

与支持 MCP 协议的大模型配合使用时，此服务支持通过自然语言与 gNucleus 交互：

1. 文本转 CAD

• “在 CAD 中绘制一个方块”
• “在 CAD 中绘制一个长 80mm、宽 40mm、高 20mm 的方块”
• “在 CAD 中绘制一个直齿轮轴”
• “在 CAD 中绘制一个齿数为 20 的直齿轮轴”
• “在 CAD 中绘制一个弯头法兰”
• “在 CAD 中绘制一个有 4 个螺栓孔的弯头法兰”

支持国际化：提示词可以使用任何语言。通常英语的效果优于其他语言，但一般来说其他语言也应该可以使用。

• 中文：“在CAD中绘制一个大小为10mm的方块”
• 西班牙语：“Dibuja un bloque cuadrado de 10 mm en CAD”

2. 文本转装配体

• “使用 text-to-cad 工具生成一个圆锥滚子轴承”
• “在 CAD 中绘制一个差速器齿轮箱”

3. CAD 结果显示

生成的结果包含设计规格，其中包括关键参数、描述以及一个可通过 3D 查看器显示模型的共享 URL。共享 URL 将在 24 小时后过期。

Claude Desktop 设置

1. 添加或更新 Claude Desktop 配置文件（claude_desktop_config.json）：

虚拟 Python 环境

如果使用虚拟 Python 环境，请使用以下配置：

{
  "mcpServers": {
    "gnucleus": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/main.py"
      ],
      "workingDirectory": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp",
      "env": {
        "GNUCLEUS_HOST": "genai.gnucleus.ai",
        "GNUCLEUS_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

全局 Python 环境

如果使用全局 Python 环境，并且已将 requirments.txt 安装到全局 Python 环境中，请使用以下配置

{
  "mcpServers": {
    "gnucleus": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/main.py"
      ],
      "workingDirectory": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp",
      "env": {
        "GNUCLEUS_HOST": "genai.gnucleus.ai",
        "GNUCLEUS_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

2. 保存文件并重启 Claude Desktop

你应该能在 Claude 中看到 gNucleus 文本转 CAD 工具

3. 与 Claude 对话以生成 CAD 模型

与 Claude 对话，并在每条提示词中添加“in CAD”，或告诉 Claude 使用“text-to-cad tools”，这样可以帮助 Claude 更好地调用 Text-To-CAD 工具。

生成结果包括设计规格（含 关键参数、描述）以及一个可通过 3D 查看器查看模型的共享链接。共享 URL 将在 24 小时后过期。如果 Claude 没有在聊天消息中输出共享 URL，你可以要求 Claude 始终输出共享 URL。

点击共享 URL，即可在 gNucleus 3D 查看器中查看 CAD 模型。你可以：

• 按住鼠标左键旋转
• 按住鼠标右键平移
• 使用鼠标中键缩放

示例 1：文本转 CAD 零件

• 输入内容和 CAD 零件设计规格

• 3D 查看器中的 CAD 零件

示例 2：文本转 CAD 装配体

• 输入内容和 CAD 装配体设计规格

• 3D 查看器中的 CAD 装配体

注意：目前尚不支持从查看器下载 CAD 模型。要下载模型，请登录 https://gnucleus.ai，并使用完整功能集尝试相同的提示词。

故障排除

CAD 模型

如果 CAD 模型看起来不正确或只生成了一部分，请尝试登录 https://gnucleus.ai，输入相同的提示词并下载 CAD 文件（例如 FreeCAD 格式）。然后在 CAD 软件（例如 FreeCAD）中打开文件。此问题通常是由零件中的 CAD 特征未完整生成导致的。

你也可以通过 https://gnucleus.ai/contact 提交错误报告或联系我们，并附上模型链接和提示词。

安全注意事项

• 妥善保管你的 .env 文件，切勿将其提交到 github
• 在安全的环境中运行此服务