gNucleus文本到CAD MCP服务器
gNucleus 是一个生成式人工智能平台，可以将文本和图像转换为可编辑的CAD模型。
此存储库包含gNucleus Text-To-CAD MCP服务器，该服务器连接到gNucleus API。它允许MCP客户端使用gNucleus的GenAI模型从文本输入生成CAD零件或组件。
先决条件
- Python 3.7+
- gNucleus开发人员帐户：
- gNucleus API密钥
设置
- 克隆此存储库
- 创建并激活虚拟环境（推荐）：
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate- 安装依赖项：
pip install -r requirements.txt- 创建一个
.env根目录中的文件，包含以下变量：
隐形用户
GNUCLEUS_HOST="genai.gnucleus.ai"
GNUCLEUS_API_KEY=企业用户
GNUCLEUS_HOST="genai.gnucleus.ai"
GNUCLEUS_API_KEY=
GNUCLEUS_ORG_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（输入：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 - 在安全环境中运行此服务器