cadquery

This MCP server exposes CAD-Query capabilities to enable conversational 3D modeling and CAD generation within the MCP framework. Core tools include verify_cad_query for validating CAD-Query generated models against defined criteria, and generate_cad_query as a stub for generating CAD-Query Python scripts from natural language descriptions. The server is tightly integrated with CAD-Query for parameterized modeling and can export results to common 3D formats like STL and STEP, with optional SVG visuals for quick model inspection. Use verify_cad_query to ensure models meet dimensional or feature-based requirements, and leverage the CAD-Query integration to iterate on designs directly from natural language prompts.

Prerequisites:

• Python 3.8+ installed on your system
• Access to the MCP development environment and uv tooling as described in your project

1. Install dependencies and set up the environment

• Ensure you have uv installed and available in your PATH

2. Install or clone the server repository

• Move to your preferred directory and install any Python dependencies listed in the project (if a requirements.txt exists)

3. Run development server or install as a module

• For development, follow the project’s guidance to run with uv and test files
• Example commands (adjust paths as needed):

# Install dependencies (if required by the project)
uv sync

# Run tests to verify server functionality
uv run python tests/test_server.py

# Run MCP Inspector for interactive testing
uv run mcp dev server.py

4. Configure Claude/Desktop integration

• Add the provided MCP server configuration to Claude Desktop or your equivalent client configuration as shown in the README

5. Validate installation

• Confirm that the cadquery-server starts and that verify_cad_query and generate_cad_query endpoints respond as documented

Tips and notes:

• The generate_cad_query tool is currently a stub; expect future updates to generate concrete CAD-Query scripts from descriptions
• Ensure your environment paths to Python and any CAD-Query dependencies are correctly configured
• Use the STL/STEP export and show_object(result) conventions when creating and displaying results
• The MCP configuration uses a simple Python command invocation; adjust /path/to/cadquery-mcp-server/server.py to point to your actual server entry point
• If you run into environment variable issues, populate the env block in the mcp_config with variables like CADQUERY_PATH or similar as required by your setup