Provides an MCP interface to a running FreeCAD instance, enabling AI clients to create, manipulate, and interact with CAD models through the FreeCAD workbench.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@FreeCAD MCP Next Create a 20mm cube in FreeCAD"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
FreeCAD MCP Next connects FreeCAD to MCP clients: Codex, GitHub Copilot Chat in Visual Studio Code, and other compatible assistants.
The project consists of two local processes:
A Workbench inside FreeCAD exposes XML-RPC on 127.0.0.1:9875.
The freecad-mcp command acts as an stdio MCP server for the AI client.
Requirements: FreeCAD 1.0 or newer, Python 3.12+, Git, and
uv.
git clone https://github.com/Lumitorus/freecad-mcp-next.git
cd freecad-mcp-next
uv sync
uv run python scripts/install_addon.pyRestart FreeCAD, select the MCP Addon workbench, and click Start RPC Server. Then connect your MCP client:
codex mcp add freecad -- uv --directory "C:\path\to\freecad-mcp-next" run freecad-mcpFor Copilot, copy .vscode/mcp.example.json to
.vscode/mcp.json, replace the path, and run the MCP: List Servers command
in VS Code.
Full guide: docs/installation.ru.md.
Special thanks to
neka-nat/freecad-mcp for the
foundation of this project.
Related MCP server: FreeCAD Robust MCP Server
FreeCAD MCP Next connects FreeCAD to MCP clients such as Codex, GitHub Copilot Chat in Visual Studio Code, and other compatible assistants.
The project uses two local processes:
A FreeCAD workbench exposes XML-RPC on 127.0.0.1:9875.
The freecad-mcp command provides an stdio MCP server to the AI client.
Requirements: FreeCAD 1.0 or newer, Python 3.12+, Git, and
uv.
git clone https://github.com/Lumitorus/freecad-mcp-next.git
cd freecad-mcp-next
uv sync
uv run python scripts/install_addon.pyRestart FreeCAD, select the MCP Addon workbench, and click Start RPC Server. Then connect your MCP client:
codex mcp add freecad -- uv --directory "C:\path\to\freecad-mcp-next" run freecad-mcpFor Copilot, copy .vscode/mcp.example.json to
.vscode/mcp.json, replace the path, and run MCP: List Servers in VS Code.
Full guide: docs/installation.en.md.
Special thanks to
neka-nat/freecad-mcp for providing
the foundation of this project.
Pull requests run linting, unit tests, package builds, and addon validation on Windows, macOS, and Linux. Release Please maintains a version/changelog PR from Conventional Commits. Merging that PR creates a draft release, verifies it on all three operating systems, attaches the artifacts, and publishes it:
a Python wheel and source distribution;
FreeCADMCP-<version>.zip for manual FreeCAD installation;
SHA-256 checksum files;
a GitHub Release containing all artifacts.
See CONTRIBUTING.md and docs/releasing.md.
Ollama provides the local language model; Continue acts as the MCP client and connects that model to FreeCAD tools. A ready-to-copy configuration is available at examples/config/continue-ollama.yaml.
Detailed Russian and English instructions:
Maintained by Lumitorus and distributed under the MIT License.
Special thanks to
neka-nat/freecad-mcp for the
foundation of this project. See NOTICE.md.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI dialogue using various LLM models via AceDataCloud
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
MCP server for generating rough-draft project plans from natural-language prompts.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lumitorus/freecad-mcp-next'
If you have feedback or need assistance with the MCP directory API, please join our Discord server