CAD-Query MCP Server
About
A server for generating and verifying CAD models using the CAD-Query Python library.
Details
- Author
- rishigundakaram
- Categories
- Developer Tools, Design
Jump to
Setup
Install CAD-Query MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/rishigundakaram/cadquery-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
A server for generating and verifying CAD models using the CAD-Query Python library.
A Model Context Protocol (MCP) server that provides CAD generation and verification tools for Claude Code. This server enables conversational 3D modeling by exposing CAD-Query functionality through MCP tools.
- verify_cad_query- Validates CAD-Query generated models against criteria
- generate_cad_query-(Stub implementation)Generates CAD-Query Python scripts from descriptions
- CAD-Query Integration- Full CAD-Query support for parametric 3D modeling
- STL/STEP Export- Direct export to 3D printing and CAD formats
- Visual Feedback- SVG generation for model inspection
# Install dependencies uv sync # For development with CAD verification capabilities uv sync --extra cad # Test the server uv run python tests/test_server.py # Run with MCP Inspector (interactive testing) uv run mcp dev server.py
Add this to your Claude Desktop configuration file:
Location:~/Library/Application Support/Claude/claude_desktop_config.json
Location:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "cadquery-server": { "command": "python", "args": ["/path/to/cadquery-mcp-server/server.py"], "env": {} } } }
Validates a CAD-Query generated model against specified criteria.
- file_path(string): Path to the CAD-Query Python file
- verification_criteria(string): Description of what to verify
{ "file_path": "models/coffee_mug.py", "verification_criteria": "coffee mug with handle, 10cm height, 8cm diameter" }
{ "status": "PASS" | "FAIL", "message": "Description of result", "file_path": "Path to verified file", "criteria": "Verification criteria used", "details": "Additional verification details" }
generate_cad_query(Stub Implementation)
Generates CAD-Query Python scripts from natural language descriptions.
NOTE: Currently returns a stub response indicating the feature is not yet implemented.
- description(string): Natural language description of the desired 3D model
- parameters(string, optional): Specific dimensions or constraints
{ "description": "Create a coffee mug with a handle, 10cm tall and 8cm diameter", "parameters": "height=100mm, diameter=80mm, handle_width=15mm" }
{ "status": "NOT_IMPLEMENTED", "message": "CAD code generation is not yet implemented", "description": "Input description", "parameters": "Input parameters", "details": "Additional information" }
All CAD-Query scripts must end withshow_object(result):
import cadquery as cq result = cq.Workplane("XY").box(10, 10, 10) show_object(result) # Required for processing
# Test server functionality uv run python tests/test_server.py # Interactive testing with MCP Inspector uv run mcp dev server.py # Run evaluations uv run python evaluations/evaluate_verify.py
The currentverify_cad_queryimplementation is a basic validator. You can enhance it to:
- Parse and validate CAD-Query syntax
- Execute model generation and catch errors
- Analyze resulting geometry dimensions
- Check for specific features and constraints
- Generate detailed validation reports
# running the MCP server npx @modelcontextprotocol/inspector \ uv \ --directory $(pwd) \ run \ server.py
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
Get access to MCP server SVG and MCP server PNG icons in your vibe-coding projects
An MCP server that allows AI assistants to interact with Adobe After Effects.
The industry-standard doctrine for safe, observable, and steerable AI agent UX — browse 10 principles, curated examples, and application guides via MCP.
Assists with aki-ui component development and usage.
745+ CSS3 animations and 9,000+ real SVG icons for AI coding agents. 10 MCP tools. Zero-clone setup via npx.
Access comprehensive documentation for Ant Design components, including examples, API references, and best practices.
Provides instant access to Apple's Human Interface Guidelines, with content auto-updated periodically.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





