Cadquery

Provides CAD-Query based CAD generation, verification, and export tools for Claude Code.

python

8

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rishigundakaram-cadquery-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/cadquery-mcp-server/server.py"
      ]
    }
  }
}

You can use the CAD-Query MCP Server to generate and verify CAD models via CAD-Query, then export them for 3D printing or CAD workflows. It enables conversational-style CAD tooling through MCP, giving you programmatic access to generation, validation, and visualization of parametric models.

How to use

Connect to the CAD-Query MCP Server from your MCP client or Claude Desktop configuration. You will be able to call two main tools: verify_cad_query to validate a CAD-Query model against specific criteria, and generate_cad_query to generate CAD-Query scripts from natural language descriptions (note that the latter is currently a stub and returns a not-implemented status). You can also export results to STL or STEP formats and generate an SVG for visual feedback.

Typical usage patterns include: verify a CAD-Query script to ensure it meets your design constraints, then export the resulting model for 3D printing or further CAD work. If you need to explore model generation from descriptions, you can prepare descriptive input and a parameter set, keeping in mind that generation is not yet implemented and will return a placeholder response.

How to install

Prerequisites: Python must be available on your system. You will also use MCP tooling in the form of uv to sync, test, and run the MCP server.

Step-by-step commands to prepare and run the server locally:

uv sync

uv sync --extra cad

uv run python tests/test_server.py

uv run mcp dev server.py

Additional configuration and notes

Claude Desktop integration requires a local MCP server descriptor. Add the following configuration to your Claude Desktop setup to point at the local Python MCP server that serves the CAD-Query tools.

{
  "mcpServers": {
    "cadquery-server": {
      "command": "python",
      "args": ["/path/to/cadquery-mcp-server/server.py"],
      "env": {}
    }
  }
}

Development and testing notes

To test server functionality and interactive evaluation, run the following commands. Use these steps to verify that the server responds to requests and that the CAD-Query scripts can be executed and inspected.

uv run python tests/test_server.py

uv run mcp dev server.py

uv run python evaluations/evaluate_verify.py

CAD-Query script requirements

All CAD-Query scripts you provide should end with a show_object call to complete processing and allow the MCP workflow to proceed.

import cadquery as cq
result = cq.Workplane("XY").box(10, 10, 10)
show_object(result)  # Required for processing