FreeCAD MCP Next

Russisch · English

Russisch

FreeCAD MCP Next verbindet FreeCAD mit MCP-Clients: Codex, GitHub Copilot Chat in Visual Studio Code und anderen kompatiblen Assistenten.

Das Projekt besteht aus zwei lokalen Prozessen:

1. Die Workbench in FreeCAD öffnet XML-RPC auf 127.0.0.1:9875.

2. Der Befehl freecad-mcp fungiert als stdio-MCP-Server für den AI-Client.

Schnellstart aus dem Quellcode

Anforderungen: FreeCAD 1.0 oder neuer, Python 3.12+, Git und uv.

git clone https://github.com/Lumitorus/freecad-mcp-next.git
cd freecad-mcp-next
uv sync
uv run python scripts/install_addon.py

Starten Sie FreeCAD neu, wählen Sie die Arbeitsumgebung MCP Addon und klicken Sie auf Start RPC Server. Verbinden Sie dann Ihren MCP-Client:

codex mcp add freecad -- uv --directory "C:\path\to\freecad-mcp-next" run freecad-mcp

Für Copilot kopieren Sie .vscode/mcp.example.json nach .vscode/mcp.json, ersetzen Sie den Pfad und führen Sie in VS Code den Befehl MCP: List Servers aus.

Vollständige Anleitung: docs/installation.ru.md.

Besonderer Dank an neka-nat/freecad-mcp für die Grundlage des Projekts.

Related MCP server: FreeCAD Robust MCP Server

English

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:

1. A FreeCAD workbench exposes XML-RPC on 127.0.0.1:9875.

2. The freecad-mcp command provides an stdio MCP server to the AI client.

Quick start from source

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.py

Restart 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-mcp

For 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.

Development and releases

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.

Continue, Ollama, and terminal clients

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:

• docs/clients.ru.md

• docs/clients.en.md

License and acknowledgements

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.