bonninr avatar

FreeCAD

bonninr/freecad_mcp

A bridge between Claude and FreeCAD's Python API that lets you create and manipulate 3D models through natural language. Exposes two core operations: get_scene_info for inspecting document state and run_script for executing arbitrary FreeCAD Python commands. You can create parametric parts, modify existing geometry, set up constraints, and automate CAD workflows by describing what you want rather than writing boilerplate code. Installation requires dropping the module into FreeCAD's Mod directory and configuring the Python path. Reach for this when you want conversational CAD design or need to prototype geometric operations quickly without diving into FreeCAD's interface.

GitHub stars
183
tools
2
last updated
Jan 27, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

get_scene_infoRetrieves comprehensive information about the current FreeCAD document, including document properties, detailed object information, sketch data, and view information.

Retrieves comprehensive information about the current FreeCAD document, including document properties, detailed object information, sketch data, and view information.

No parameter schema in public metadata yet.

run_scriptExecutes arbitrary Python code within the FreeCAD context to perform complex operations, create or modify objects, and automate tasks using FreeCAD's Python API.

Executes arbitrary Python code within the FreeCAD context to perform complex operations, create or modify objects, and automate tasks using FreeCAD's Python API.

No parameter schema in public metadata yet.

Sponsors

Readme

FreeCAD MCP (Model Control Protocol)

Overview

The FreeCAD MCP (Model Control Protocol) provides a simplified interface for interacting with FreeCAD through a server-client architecture. This allows users to execute commands and retrieve information about the current FreeCAD document and scene.

https://github.com/user-attachments/assets/5acafa17-4b5b-4fef-9f6c-617e85357d44

Configuration

To configure the MCP server, you can use a JSON format to specify the server settings. Below is an example configuration:

{
    "mcpServers": {
        "freecad": {
            "command": "C:\\ProgramData\\anaconda3\\python.exe",
            "args": [
                "C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
            ]
        }
    }
}

Configuration Details

  • command: The path to the Python executable that will run the FreeCAD MCP server. This can vary based on your operating system:
    • Windows: Typically, it might look like C:\\ProgramData\\anaconda3\\python.exe or C:\\Python39\\python.exe.
    • Linux: It could be /usr/bin/python3 or the path to your Python installation.

View the full README on GitHub

Details

Repository
github.com/bonninr/freecad_mcp
Category
Data & Analytics

Related Data & Analytics MCP servers

View all
1egebese avatarSEO Researchegebese/seo-research-mcpProvides SEO data (backlinks, keywords, traffic, and difficulty) via MCP integration with Ahrefs data sources.180stars
2faucetdb avatarFaucetfaucetdb/faucetSQL database to MCP tools and REST API: PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake.170stars
3alphavantage avatarAlpha Vantage Mcpalphavantage/alpha_vantage_mcpReal-time financial market data: stocks, forex, crypto, commodities, and economic indicators168stars
4imbenrabi avatarFinancial Modeling Prep MCP Serverimbenrabi/financial-modeling-prep-mcp-serverMCP server for Financial Modeling Prep API with 250+ financial data tools149stars
5dave-london avatarPare Dockerdave-london/parePare Docker ג€” Structured Docker operations (ps, images, logs, build, compose) as typed JSON.128stars
6dave-london avatarPare Godave-london/parePare Go ג€” Structured Go tool output (build, test, vet, fmt, mod) as typed JSON diagnostics.128stars