AI导哈

文本转CAD生成服务

gNucleus是一个生成式AI平台，可将文本和图像转换为可编辑的CAD模型。该服务通过MCP服务器连接gNucleus API，允许客户端从文本输入生成CAD零件或装配体。

  • by gNucleus
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 gNucleus/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. 克隆此存储库

  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密钥

  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工具

3.与Claude聊天生成CAD模型

与Claude聊天，在每个提示中添加“在CAD中”或告诉Claude使用“文本到CAD工具”可以帮助Claude更好地触发文本到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
  • 在安全环境中运行此服务器

相关 MCP