Overview
gNucleus Text To CAD MCP server is an MCP server that connects to the gNucleus GenAI API to convert natural language prompts into editable CAD models. It exposes a single MCP tool, text_to_cad(input: str), that can generate CAD parts or assemblies from text. The server requires Python 3.7+ and a gNucleus API key. Run it with python main.py and test via the MCP inspector. Configuration is done with a .env file; hosts are set to genai.gnucleus.ai and keys provided for personal or enterprise use, with an optional GNUCLEUS_ORG_ID for enterprise accounts. API credits start at 200. The server's output CAD representations include a design spec with Key Parameter and Description, and a shareable 3D viewer URL that expires after 24 hours. Prompts support internationalization (i18n), with examples in English, Chinese, and Spanish. The README also provides Claude Desktop integration templates to run the MCP server and notes that downloading CAD models from the viewer is not yet supported. A caution about securely storing the .env file is included, along with troubleshooting advice and login steps for full downloads on gnucleus.ai.
Features
text_to_cad(input: str)
Exposes the MCP tool to generate CAD from textual input.
CAD parts and assemblies generation
Generates CAD parts or assemblies from natural language prompts using gNucleus GenAI models.
Multilingual / i18n prompts
Supports prompts in multiple languages, including English, Chinese, and Spanish.
Shareable 3D viewer URL
Returns a URL for a 3D viewer displaying the generated CAD; the link expires after 24 hours.
Easy setup and enterprise options
Configurable via .env with host and API key; supports personal and enterprise keys, and optional ORG ID for enterprises.
MCP inspector testing
Test and validate prompts using the MCP inspector tool.
Claude Desktop integration
Includes configuration templates for running the MCP server from Claude Desktop in both virtual and global Python environments.
Design specification output
Generated CAD results include a design spec with Key Parameter and Description.
