Skip to content
Back to search

multiCAD-mcp

MCP server for use CAD software through AI assistants like Claude for Desktop or Cursor

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ancode666--multicad-mcp/badge.svg)](/listings/ancode666--multicad-mcp)

HTML

<a href="/listings/ancode666--multicad-mcp"><img src="/api/listings/ancode666--multicad-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Detailed installation instructions are available in [docs/01-SETUP.md](docs/01-SETUP.md).

Quick start:

# Install uv (if not installed)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone
git clone https://github.com/AnCode666/multiCAD-mcp.git
cd multiCAD-mcp
uv sync --dev
uv run python -m pip install --upgrade pywin32

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 240 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # multiCAD-mcp
  2. Control your CAD applications with your AI assistant through the Model Context Protocol (MCP).
  3. [![Documentation](https://img.shields.io/badge/docs-mkdocs--material-blue?logo=readthedocs)](https://AnCode666.github.io/multiCAD-mcp/)
  4. [![License](https://img.shields.io/github/license/AnCode666/multiCAD-mcp)](LICENSE)
  5. [![Python](https://img.shields.io/badge/python-3.10%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
  6. [![MCP](https://img.shields.io/badge/MCP-FastMCP%202.0-green)](https://github.com/jlowin/fastmcp)
  7. **Documentation**: https://AnCode666.github.io/multiCAD-mcp/
  8. ## What is multiCAD-mcp?
  9. multiCAD-mcp is an MCP server that lets you control your CAD software using AI assistants like Claude for desktop or Cursor. Whether you're drawing shapes, managing layers, automating repetitive tasks, o doing complex ones, you can do it all through text-based instructions.
  10. ## Features
  11. - **Multiple CAD Support**: Works with AutoCAD®, ZWCAD®, GstarCAD®, and BricsCAD®
  12. - **7 Unified MCP Tools**: Clean access to **56 CAD commands** for drawing, layers, entities, blocks, and files
  13. - **Block Attributes** (v0.2.0+): Read and write block attribute values
  14. - **Block Creation**: Create blocks from entities or user selection
  15. - **Simple command execution**: "Draw a red circle at 50,50 with radius 25" - no complex syntax needed
  16. - **Complex tasks execution**: "Draw the graph of y = sen(X) and label the axes"
  17. - **Simple Integration**: Works with Claude, Cursor, VS Code, and any MCP-compatible client
  18. - **Fast & Reliable**: Efficient COM-based architecture for real-time CAD control
  19. - **Flexible**: Direct tool calls or natural language - choose what works for you
  20. ## System Requirements
  21. - **Windows OS** (required - uses Windows COM technology)
  22. - **Python 3.10 or higher**
  23. - **One or more CAD applications** installed in your computer
  24. ## Installation
  25. Detailed installation instructions are available in [docs/01-SETUP.md](docs/01-SETUP.md).
  26. Quick start:
  27. ```powershell
  28. # Install uv (if not installed)
  29. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  30. # Clone
  31. git clone https://github.com/AnCode666/multiCAD-mcp.git
  32. cd multiCAD-mcp
  33. uv sync --dev
  34. uv run python -m pip install --upgrade pywin32
  35. ```
  36. ## Setup with Claude Desktop
  37. Add this to your `claude_desktop_config.json`:
  38. ```json
  39. {
  40. "mcpServers": {
  41. "multiCAD": {
  42. "command": "C:\\path\\to\\multiCAD-mcp\\.venv\\Scripts\\python.exe",
  43. "args": ["C:\\path\\to\\multiCAD-mcp\\src\\server.py"]
  44. }
  45. }
  46. }
  47. ```
  48. **Important**: Use the full path to the Python interpreter in your virtual environment (`.venv\Scripts\python.exe`), not the system `py` command. This ensures Claude Desktop uses the correct Python environment with all required dependencies installed.
  49. Replace `C:\path\to\multiCAD-mcp` with your actual installation path.
  50. ## Usage Examples
  51. ### Direct Tool Calls
  52. multiCAD-mcp provides **7 unified MCP tools** that provide access to **56 different CAD commands**. This architecture is designed for high efficiency, allowing multiple operations to be dispatched in single calls, reducing API overhead by up to 70%.
  53. - **Drawing & Shapes**: Lines, circles, arcs, rectangles, polylines, splines, and tables.
  54. - **Block Management**: Create blocks (from entities or selection), insert (batch/single), list, and audit.
  55. - **Layer Management**: Create, list, rename/delete (batch), and toggle visibility.
  56. - **Entity Manipulation**: Move, rotate, scale, copy/paste, and selection (by type/layer/color).
  57. - **Property Management**: Change color/layer (batch/single) and set color ByLayer.
  58. - **Data & Export**: Extract data (JSON), export to Excel (total or selected), and entity debug.
  59. - **View & Navigation**: Zoom extents, fit view, and undo/redo operations.
  60. - **Files & Session**: Save (DWG/DXF/PDF), new/close drawings, and multi-drawing switching.
  61. - **Connection & Control**: Connection lifecycle, diagnostics, and natural language fallback.
  62. > [!TIP]
  63. > Each tool accepts multiple operations in a single call using a compact shorthand format, reducing API overhead by up to 70%.
  64. ### Selected Entity Export
  65. Export or extract data from only the entities currently selected in your CAD viewport:
  66. ```text
  67. # Export selected entities to Excel
  68. export_data(scope="selected", format="excel", filename="selected_entities.xlsx")
  69. # Extract selected entity data as JSON
  70. export_data(scope="selected", format="json")
  71. ```
  72. ### Complex Tasks
  73. You can ask your AI assistant to execute complex tasks that require multiple tools, such as drawing graphs of equations, complex title blocks, or data tables.
  74. ## Configuration
  75. Edit `src/config.json` to customize:
  76. ```json
  77. {
  78. "logging_level": "INFO",
  79. "cad": {
  80. "autocad": {
  81. "startup_wait_time": 20,
  82. "command_delay": 0.5
  83. }
  84. },
  85. "dashboard": {
  86. "port": 8888
  87. },
  88. "output": {
  89. "directory": "~/Documents/multiCAD Exports",
  90. "allow_arbitrary_paths": true
  91. }
  92. }
  93. ```
  94. **Key settings**:
  95. - **`logging_level`**: Set to `DEBUG`, `INFO`, `WARNING`, or `ERROR` to control log verbosity
  96. - **`startup_wait_time`**: Seconds to wait for CAD application to start (increase if CAD is slow)
  97. - **`command_delay`**: Delay between commands in seconds
  98. - **`dashboard.port`**: Web dashboard port (default: 8888)
  99. - **`open_dashboard`**: [host, port] — open web dashboard in browser (default from config.json: 8888)
  100. - **`output.directory`**: Default directory for saved drawings and exports
  101. - **`output.allow_arbitrary_paths`**: Set to `true` to allow saving files to any absolute path on the system, bypassing path-traversal prevention checks.
  102. ## Troubleshooting
  103. ### Checking Logs
  104. multiCAD-mcp generates detailed logs to help diagnose issues:
  105. **Log Location**: `logs/multicad_mcp.log` (created automatically in the project's `logs/` directory)
  106. **View logs**:
  107. ```powershell
  108. # View latest 50 log entries
  109. Get-Content logs/multicad_mcp.log -Tail 50
  110. # View all logs
  111. Get-Content logs/multicad_mcp.log
  112. # Monitor logs in real-time (updates automatically)
  113. Get-Content logs/multicad_mcp.log -Wait -Tail 10
  114. ```
  115. **Adjust log level** in `src/config.json`:
  116. ```json
  117. {
  118. "logging_level": "DEBUG"
  119. }
  120. ```
  121. Available levels (from most to least verbose):
  122. - `DEBUG`: Detailed information for diagnosing problems
  123. - `INFO`: General informational messages (default)
  124. - `WARNING`: Warning messages for potential issues
  125. - `ERROR`: Error messages only
  126. **Note**: Restart the MCP server after changing configuration.
  127. ### "Connection failed"
  128. - Make sure your CAD application is running
  129. - Check that you have the correct version installed
  130. - Verify Windows COM is properly configured
  131. - Use `manage_session` with `{"action": "status"}` to diagnose the issue
  132. - Check logs for detailed error messages (see above)
  133. The dashboard provides a real-time view of the CAD state. You can manually refresh the data using the "Refresh Now" button.
  134. - **Dashboard Port**: Change `dashboard.port` in `src/config.json` to your preferred port.
  135. - **Manual Refresh**: Click the refresh button to sync with current CAD state.
  136. ### "Not connected"
  137. - The server automatically connects on first use
  138. - If it fails, restart the CAD application and try again
  139. - Use `manage_session` with `{"action": "connect"}` to re-establish connection
  140. - Review logs to identify connection issues
  141. ### Commands not working
  142. - Check your CAD application's command line for messages or errors
  143. - Ensure coordinates are in valid format (e.g., "0,0" for 2D, "0,0,0" for 3D)
  144. - Verify connection status with `manage_session` → `{"action": "status"}`
  145. - Enable DEBUG logging to see detailed command execution information
  146. ## Documentation
  147. - [**Setup & Installation**](docs/01-SETUP.md) - detailed setup guide and Claude Desktop integration.
  148. - [**Architecture**](docs/02-ARCHITECTURE.md) - system design and extension guide.
  149. - [**Troubleshooting**](docs/04-TROUBLESHOOTING.md) - solutions for common issues.
  150. - [**Reference**](docs/05-REFERENCE.md) - complete MCP tool reference.
  151. - [**Changelog**](docs/07-CHANGELOG.md) - version history.
  152. ## Supported CAD Applications
  153. | Application | Status | Notes |
  154. |------------|--------|-------|
  155. | AutoCAD 2018+ | ✅ Full Support | Primary implementation |
  156. | ZWCAD 2020+ | ✅ Full Support | Uses AutoCAD-compatible API |
  157. | GstarCAD 2020+ | ✅ Full Support | Uses AutoCAD-compatible API |
  158. | BricsCAD 21+ | ✅ Full Support | Uses AutoCAD-compatible API |
  159. ## Project Status
  160. **Version 0.2.0** - Unified tool architecture, block attribute management, and modern packaging.
  161. ## License
  162. Apache License 2.0 - see [LICENSE](LICENSE) file for details.
  163. ## Acknowledgments
  164. This project builds upon:
  165. - [CAD-MCP](https://github.com/daobataotie/CAD-MCP)
  166. - [Easy-MCP-AutoCAD](https://github.com/zh19980811/Easy-MCP-AutoCad)
  167. ## Support
  168. For issues, questions, or feature requests, please open an issue on the repository.
  169. ---
  170. **Need help setting up?** Start with the installation steps above.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.