gNucleus Text To CAD MCP Server

What does “gNucleus Text To CAD” MCP Server do?

The gNucleus Text To CAD MCP server is a bridge that enables AI assistants and LLM-powered tools to generate CAD (Computer-Aided Design) models directly from natural language descriptions. By connecting to the gNucleus GenAI API, this server empowers developers and AI clients to translate text or image prompts into editable CAD parts or assemblies. This streamlines workflows for engineers, designers, and developers by allowing rapid prototyping, design generation, and collaborative modification via simple language instructions. The server exposes this functionality through the Model Context Protocol (MCP), making it accessible for integration into various development tools and AI environments, significantly enhancing the automation and efficiency of design processes.

List of Prompts

• Text to CAD
  Define a natural language prompt that describes a CAD part to generate, such as “draw a block in CAD” or “draw a spur gear shaft with number_teeth=20”.
• Text to Assembly
  Use a prompt like “Generate a tapered roller bearing” to create more complex assemblies.
• (No explicit standardized prompt templates are detailed, but the above illustrate the form of prompts used.)

List of Resources

(No explicit MCP resources are documented in the repository.)

List of Tools

• text_to_cad(input: str)
  • Generates a CAD model from the provided text input using the gNucleus GenAI models. The result includes key parameters, a description, and a shared URL to view the 3D model (expires in 24 hours).

Use Cases of this MCP Server

• Rapid CAD Prototyping from Text
  • Instantly generate CAD parts or assemblies by describing them in natural language, enabling faster prototyping and ideation for engineers and product designers.
• Collaborative Design Iteration
  • Multiple stakeholders can suggest modifications or new parts via text, streamlining team-based design and feedback cycles.
• Automated Assembly Generation
  • Automate the creation of complex assemblies (e.g., bearings, gears) through simple prompts, reducing manual CAD work and errors.
• Educational Tools
  • Enhance engineering or design education by allowing students to learn CAD concepts interactively through text commands.
• Multilingual CAD Design
  • Supports prompts in multiple languages (e.g., Chinese, Spanish), making CAD generation accessible to non-English speakers.

How to set it up

Windsurf

(No Windsurf-specific setup documentation is provided in the repository.)

Claude

1. Ensure you have Python 3.7+ and have installed the dependencies in a virtual or global environment.
2. Obtain your gNucleus API key and configure your .env file as described in the prerequisites.
3. Add or update your claude_desktop_config.json:
   • For a virtual environment:

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

   • For a global environment:

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

4. Save your configuration and (re)start Claude Desktop.
5. Verify that the MCP server is running and accessible.

Securing API Keys

• API keys are stored in the env section of your configuration. Example:

  "env": {
    "GNUCLEUS_HOST": "genai.gnucleus.ai",
    "GNUCLEUS_API_KEY": "YOUR_API_KEY_HERE"
  }
  

Cursor

(No Cursor-specific setup documentation is provided in the repository.)

Cline

(No Cline-specific setup documentation is provided in the repository.)

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "gnucleus": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change "gnucleus" to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the available documentation, the gNucleus Text To CAD MCP server scores well for practical utility and clarity, but lacks resource definitions and some advanced MCP features. It is highly usable for its core purpose, but not fully featured for all MCP scenarios.

MCP Score

Rating:
I would rate this MCP server a 6/10. It is robust for its main goal (text-to-CAD generation) and is ready for integration, but is missing some advanced MCP features (resources, roots, sampling support) and setup guides for some platforms.