Back to Home
spkane icon

freecad-addon-robust-mcp-server

Verified Safe

by spkane

Overview

Enables AI assistants to integrate with FreeCAD for assisted development and debugging of 3D models, macros, and workbenches, supporting various CAD operations and environment introspection.

Installation

Run Command
docker run --rm -i --add-host=host.docker.internal:host-gateway -e FREECAD_MODE=xmlrpc -e FREECAD_SOCKET_HOST=host.docker.internal spkane/freecad-robust-mcp

Environment Variables

  • FREECAD_MODE
  • FREECAD_PATH
  • FREECAD_SOCKET_HOST
  • FREECAD_SOCKET_PORT
  • FREECAD_XMLRPC_PORT
  • FREECAD_TIMEOUT_MS
  • FREECAD_MAX_OUTPUT_SIZE
  • FREECAD_TRANSPORT
  • FREECAD_HTTP_PORT
  • FREECAD_LOG_LEVEL
  • FREECAD_ENABLE_SANDBOX
  • FREECAD_ALLOW_FILE_ACCESS
  • FREECAD_ALLOW_NETWORK_ACCESS

Security Notes

CRITICAL: The `execute_python` tool allows execution of arbitrary Python code within the FreeCAD environment, which can lead to severe security vulnerabilities if untrusted input is processed. This grants full access to the underlying system and FreeCAD's capabilities, including file system access and network operations (if FreeCAD itself is configured for them). While the `ServerConfig` includes `enable_sandbox: True` and `allow_network_access: False`, the effectiveness and scope of this sandbox are not explicitly detailed, and the direct `exec()` usage in the `_execute_code` method bypasses Python's normal security checks. Deploying this server on a system with sensitive data or network access, especially if exposed beyond localhost, is a significant risk. Users must carefully manage the trust level of the AI assistant and the code it generates. Additionally, the default `socket_host` can be configured to `0.0.0.0` making the server externally accessible.

Similar Servers

Stats

Interest Score45
Security Score3
Cost ClassHigh
Avg Tokens5000
Stars6
Forks0
Last Update2026-01-19

Tags

FreeCADAICADMCP3D ModelingAutomationDebuggingPython