FreeCAD MCP

Name: FreeCAD MCP
Author: neka-nat

@neka-nat

リポジトリ

FreeCAD MCP について

FreeCAD MCP(Model Context Protocol) server

#mcp #freecad #claude

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

neka-nat

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

ツール

Create a new document in FreeCAD.

Create a new object in FreeCAD.

Edit an object in FreeCAD.

Delete an object in FreeCAD.

Execute arbitrary Python code in FreeCAD.

Insert a part from the [parts library](https://github.com/FreeCAD/FreeCAD-library).

Get a screenshot of the active view.

Get all objects in a document.

Get an object in a document.

Get the list of parts in the [parts library](https://github.com/FreeCAD/FreeCAD-library).

Run the CalculiX solver on an existing `Fem::FemAnalysis` and return summary results (max von Mises stress, max displacement, node count, working directory). Auto-creates a `SolverCcxTools` if the analysis has none. See [`examples/cantilever_fem.py`](examples/cantilever_fem.py) for an end-to-end usage example.

概要

What is FreeCAD MCP?

FreeCAD MCP is a Model Context Protocol (MCP) server that enables you to control FreeCAD, the open-source parametric 3D CAD modeler, directly from Claude Desktop. It is designed for users who want to automate CAD design tasks, generate parts from descriptions or drawings, or integrate FreeCAD with AI-based workflows.

How to use FreeCAD MCP?

Install the FreeCAD MCP addon by copying the addon/FreeCADMCP directory to your FreeCAD Mod folder (paths differ by OS). Then restart FreeCAD, switch to the “MCP Addon” workbench, and click “Start RPC Server” in the toolbar. Configure Claude Desktop by editing claude_desktop_config.json to use uvx freecad-mcp as the MCP server command. Optionally enable auto-start of the RPC server via the FreeCAD MCP menu, or set up remote connections with --host and allowed IPs.

Key features of FreeCAD MCP

Create, edit, and delete FreeCAD objects via natural language
Execute arbitrary Python code in FreeCAD’s environment
Insert parts from the FreeCAD parts library
Capture screenshots of the active 3D view
Run CalculiX FEM analysis and retrieve summary results
Support for remote connections over a network
Auto-start RPC server on FreeCAD launch

Use cases of FreeCAD MCP

Design mechanical parts (e.g., a flange or toy car) from user descriptions
Generate 3D models from 2D technical drawings
Automate repetitive CAD operations with AI-driven prompts
Perform finite element analysis (FEM) on models and inspect results
Manage multiple documents and objects in FreeCAD remotely via Claude

FAQ from FreeCAD MCP

What tools are available in FreeCAD MCP?

The server provides 11 tools: create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, get_parts_list, and run_fem_analysis.

How do I enable remote connections to FreeCAD MCP?

In the FreeCAD MCP toolbar, check Remote Connections to bind to 0.0.0.0. Then use Configure Allowed IPs to specify comma-separated IP addresses or CIDR subnets. On the Claude Desktop side, pass the --host flag with the FreeCAD machine’s IP address or hostname.

How can I make the RPC server start automatically?

Switch to the MCP Addon workbench, open the FreeCAD MCP menu, and check Auto-Start Server. The setting is saved to freecad_mcp_settings.json and persists across sessions.

Is a Python environment required to run FreeCAD MCP?

Yes. Pre-installation of uvx (from the Astral uv tool) is required for the Claude Desktop configuration.

Can I receive only text feedback without image data?

Yes. Add the --only-text-feedback flag in the claude_desktop_config.json args to disable image-based feedback and use only textual responses.

「その他」の他のコンテンツ

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K