FreeCAD MCP Next

Русский · English

Русский

FreeCAD MCP Next 将 FreeCAD 与 MCP 客户端连接起来：Codex、Visual Studio Code 中的 GitHub Copilot Chat 以及其他兼容的助手。

该项目由两个本地进程组成：

1. FreeCAD 内部的工作台在 127.0.0.1:9875 上打开 XML-RPC。

2. freecad-mcp 命令作为 AI 客户端的 stdio MCP 服务器运行。

从源代码快速开始

要求：FreeCAD 1.0 或更高版本、Python 3.12+、Git 和 uv。

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

重新启动 FreeCAD，选择 MCP Addon 工作台，然后点击 Start RPC Server。接着连接您的 MCP 客户端：

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

对于 Copilot，请将 .vscode/mcp.example.json 复制到 .vscode/mcp.json，替换路径，然后在 VS Code 中运行 MCP: List Servers 命令。

完整指南：docs/installation.ru.md。

特别感谢 neka-nat/freecad-mcp 为项目提供基础。

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.