文本到CAD-MCP

Name: 文本到CAD-MCP
Author: gNucleus

作者：gNucleus13 星标更新：2025-07-30

安装使用来源：spider==github.com

项目介绍

gNucleus 文本转CAD MCP服务器

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

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

预备条件

Python 3.7+
gNucleus 开发者账户，包括：
- gNucleus API密钥

安装步骤

克隆此仓库

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

python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

安装依赖项：
```
pip install -r requirements.txt
```

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

个人用户

GNUCLEUS_HOST="genai.gnucleus.ai"
GNUCLEUS_API_KEY=<你的个人API密钥>

企业用户

GNUCLEUS_HOST="genai.gnucleus.ai"
GNUCLEUS_API_KEY=<你的团队密钥>
GNUCLEUS_ORG_ID=<你的团队ID>

获取gNucleus API密钥

gNucleus账户：在https://gnucleus.ai/注册
API密钥：在gNucleus中创建个人访问令牌：
- 前往用户配置文件（点击右上角的用户图标）
- 前往“账户”
- 点击“生成新API密钥”以生成新的API密钥
- 每个账户初始有200次免费API调用机会

运行服务器

启动MCP服务器：

python main.py

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

npx @modelcontextprotocol/inspector python3 main.py

可用的MCP工具

以下MCP工具可用：

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

使用LLMs的示例提示

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

1. 文本转CAD

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

多语言支持：你可以使用任何语言作为提示，通常英语效果更好，但其他语言也应能工作。

中文："在CAD中绘制一个大小为10mm的方块"
西班牙语："在CAD中绘制一个10mm的方形块"

2. 文本转装配件

"使用文本转CAD工具生成一个锥形滚子轴承"
"在CAD中绘制一个差速器齿轮箱"

3. 结果CAD显示

生成的结果包括设计规范中的关键参数、描述以及带有3D显示查看器的共享链接。共享链接将在24小时内过期。

Claude桌面设置

1. 添加或更新Claude桌面配置文件(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安装到全局环境中，请使用以下配置：

{
  "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",
      }
    }
  }
}