FreeCAD Robust

v1.0.0Developer Toolsstable

The FreeCAD Robust MCP server and MCP Bridge Workbench/Addon

addonsaifreecadmcp-serverworkbench
Share:
93
Stars
0
Downloads
0
Weekly
0/5

What is FreeCAD Robust?

FreeCAD Robust is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to freecad robust mcp server and mcp bridge workbench/addon

The FreeCAD Robust MCP server and MCP Bridge Workbench/Addon

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • The FreeCAD Robust MCP server and MCP Bridge Workbench/Addon

Use Cases

CAD design and modeling through AI
FreeCAD workbench and addon integration
spkane

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx freecad-addon-robust

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use FreeCAD Robust

The FreeCAD Robust MCP Server connects AI assistants to a running FreeCAD instance, exposing over 150 tools for parametric 3D CAD modeling through natural language. It supports creating primitives, sketches, PartDesign features, boolean operations, patterns, and exports — all driven by conversation. A companion Workbench/Addon installs directly into FreeCAD via its built-in Addon Manager and starts the bridge server with a single button click. Engineers and makers can describe parts in plain language and watch them materialize in FreeCAD in real time.

Prerequisites

  • FreeCAD 0.21 or 1.0+ installed
  • Python 3.11 (for ABI compatibility with the pip package)
  • pip or Docker for installing the MCP server component
  • An MCP client such as Claude Desktop, VS Code, or Cursor
1

Install the FreeCAD Robust MCP package

Install the MCP server Python package via pip. This installs the freecad-mcp command that your MCP client will invoke.

pip install freecad-robust-mcp
2

Install the MCP Bridge Workbench inside FreeCAD

Open FreeCAD, go to Tools > Addon Manager, search for 'Robust MCP Bridge', and click Install. Restart FreeCAD when prompted. This workbench starts the local bridge server that the MCP server communicates with.

3

Start the MCP Bridge from FreeCAD

In FreeCAD, switch to the 'Robust MCP Bridge' workbench from the workbench selector, then click the 'Start MCP Bridge' button in the toolbar. The bridge listens on port 9875 (XML-RPC) by default.

4

Configure your MCP client

Add the freecad-mcp server to your MCP client's config. The FREECAD_MODE env var selects the transport; xmlrpc is the default and works on all platforms.

{
  "mcpServers": {
    "freecad": {
      "command": "freecad-mcp",
      "env": {
        "FREECAD_MODE": "xmlrpc",
        "FREECAD_XMLRPC_PORT": "9875",
        "FREECAD_TIMEOUT_MS": "30000"
      }
    }
  }
}
5

Verify the connection

Restart your MCP client and ask it to get the FreeCAD version. If the bridge is running, the tool should return the FreeCAD version string. Then try creating a simple box to confirm write access.

FreeCAD Robust Examples

Client configuration

Claude Desktop config using the freecad-mcp command installed via pip, connecting to the XML-RPC bridge on the default port.

{
  "mcpServers": {
    "freecad": {
      "command": "freecad-mcp",
      "env": {
        "FREECAD_MODE": "xmlrpc",
        "FREECAD_XMLRPC_PORT": "9875",
        "FREECAD_TIMEOUT_MS": "30000"
      }
    }
  }
}

Prompts to try

Natural-language CAD tasks you can direct at FreeCAD through this MCP server.

- "Create a new FreeCAD document and add a 50x30x10mm box."
- "Add a cylinder with radius 8mm and height 40mm, then subtract it from the box."
- "Create a sketch on the top face, draw a 20mm circle, and pad it 15mm."
- "Export the current model as an STL file to /tmp/part.stl."
- "Take a screenshot of the current 3D view and show me what's been modeled."

Troubleshooting FreeCAD Robust

Connection refused on port 9875 when the MCP server starts

The FreeCAD bridge must be running before the MCP server connects. Open FreeCAD, switch to the Robust MCP Bridge workbench, and click 'Start MCP Bridge'. Confirm the bridge is listening with 'lsof -i :9875' on macOS/Linux.

'freecad-mcp: command not found' error in the MCP client

The pip install may have placed the binary in a directory not on your PATH. Run 'pip show freecad-robust-mcp' to find the install location, then add the Scripts or bin directory to PATH, or use the full path in the 'command' field of your MCP client config.

FREECAD_MODE=embedded crashes on macOS or Windows

Embedded mode is supported only on Linux. On macOS and Windows, use FREECAD_MODE=xmlrpc (default) or FREECAD_MODE=socket instead.

Frequently Asked Questions about FreeCAD Robust

What is FreeCAD Robust?

FreeCAD Robust is a Model Context Protocol (MCP) server that freecad robust mcp server and mcp bridge workbench/addon It connects AI assistants to external tools and data sources through a standardized interface.

How do I install FreeCAD Robust?

Follow the installation instructions on the FreeCAD Robust GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with FreeCAD Robust?

FreeCAD Robust works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is FreeCAD Robust free to use?

Yes, FreeCAD Robust is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "freecad-addon-robust": { "command": "npx", "args": ["-y", "freecad-addon-robust"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use FreeCAD Robust?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides