Text To Cad MCP

gNucleus文本到CAD MCP服务器

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

此存储库包含gNucleus Text-To-CAD MCP服务器，该服务器连接到gNucleus API。它允许MCP客户端使用gNucleus的GenAI模型从文本输入生成CAD零件或组件。

先决条件

• Python 3.7+
• gNucleus开发人员帐户：

- gNucleus API密钥

设置

1. 克隆此存储库

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

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

1. 安装依赖项：

   pip install -r requirements.txt

1. 创建一个 .env 根目录中的文件，包含以下变量：

隐形用户

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=

企业用户

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=
   GNUCLEUS_ORG_ID=

获取gNucleus API密钥

1. gNucleus帐户：注册https://gnucleus.ai/
2. API密钥：在gNucleus中创建个人访问令牌：

- 转到用户配置文件（单击右上角的用户图标） - 转到“帐户” - 点击“生成新的API密钥”生成新的API密钥 - 每个账户从200个免费API信用开始

运行服务器

启动MCP服务器：

python main.py

您可以使用检查器通过运行以下命令来测试MCP服务器

npx @modelcontextprotocol/inspector python3 main.py

可用的MCP工具

以下MCP工具可用：

• text_to_cad（输入：str） -根据输入生成CAD

LLM提示示例

当与支持MCP协议的LLM一起使用时，此服务器支持与gNucleus的自然语言交互：

1.文本到CAD

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

i18n支持：您可以使用任何语言作为提示，一般来说，英语比其他语言更好，但一般来说它应该能正常工作。

• Chinese: "在CAD中绘制一个大小为10mm的方块"
• 西班牙语：“在CAD中绘制10毫米的方形块”

2.提交至大会的文本

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

3.结果CAD显示

生成的结果包括设计规范 关键参数, 描述 以及与3D显示查看器共享的URL。共享URL将在24小时后过期。

Claude桌面设置

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环境，并将requirements.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工具 gNucleus Text-To-CAD Tool

3.与Claude聊天生成CAD模型

与Claude聊天，在每个提示中添加“在CAD中”或告诉Claude使用“文本到CAD工具”可以帮助Claude更好地触发文本到CAD的工具。

生成的结果包括设计规范 关键参数, 描述 以及与3D显示查看器的共享链接。共享URL将在24小时后过期。如果Claude没有在聊天消息中输出共享URL，您可以要求Claude始终输出共享URL。

点击共享URL，它将在gNucleus 3D查看器中显示CAD模型，您可以

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

*示例1：文本到CAD零件*

• 输入和CAD零件设计规范

Chat with Claude to generate CAD

• 3D查看器中的CAD零件

Display the generated CAD model in gNucleus Viewer

*示例2：文本到CAD装配*

• 输入和CAD装配设计规范

Chat with Claude to generate CAD Assembly

• 3D查看器中的CAD装配

Display the generated CAD Assembly in gNucleus Viewer

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

故障排除

cad模型

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

您还可以报告错误或通过模型链接与我们联系，并在https://gnucleus.ai/contact.

安全考虑

• 保护您的 .env 文件，永远不要将其提交到github
• 在安全环境中运行此服务器