FreeCAD MCP
MCP-сервер для управления FreeCAD из Claude Desktop и других клиентов: создание и правка моделей, запуск скриптов и FEM-анализ
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Выполняет произвольный Python-код внутри FreeCAD
- Создает и меняет документы и модели в приложении на хосте
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/freecad-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio freecad -- uvx freecad-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"freecad","type":"stdio","command":"uvx","args":["freecad-mcp"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"freecad": {
"type": "stdio",
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add freecad -- uvx freecad-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.freecad]
command = "uvx"
args = ["freecad-mcp"]Если файл уже есть, допишите блок в конец.
Выполните в терминале
gemini mcp add -s user freecad uvx freecad-mcpИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"freecad": {
"type": "local",
"command": [
"uvx",
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Склонируй репозиторий и скопируй addon/FreeCADMCP в каталог аддонов FreeCAD, затем в программе запусти RPC-сервер. В конфигурацию MCP добавь сервер freecad с командой uvx и аргументом freecad-mcp.
Другие способы из описания автора
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": ["freecad-mcp"]
}
}
}MCP-сервер запускается через uvx. Отдельно установите аддон FreeCADMCP и запустите RPC-сервер внутри FreeCAD.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает ИИ-клиент с FreeCAD и позволяет агенту создавать и редактировать 3D-модели, читать содержимое документов, выполнять Python-скрипты внутри FreeCAD и запускать расчеты методом конечных элементов. Он состоит из двух частей: аддона, который работает внутри FreeCAD и поднимает RPC-сервер, и MCP-сервера, который запускает клиент через uvx. По умолчанию соединение идет через localhost. Через набор инструментов агент может собирать деталь по описанию, строить модель по 2D-чертежу и вести проектирование пошагово. В репозитории есть примеры интеграции с ADK и LangChain и демонстрации на гифках.
Для кого. Для инженеров, конструкторов и разработчиков, которые проектируют в FreeCAD с помощью ИИ-агента.
Подходит, если
- Нужно создать или изменить 3D-модель во FreeCAD по описанию
- Нужно построить деталь по 2D-чертежу
- Нужно запустить Python-скрипт или FEM-анализ внутри FreeCAD
Не подходит, если
- FreeCAD не установлен или аддон с RPC-сервером не запущен
- Нужна лишь консультация по FreeCAD без управления приложением
Пример запроса к агенту
Создай во FreeCAD фланец с четырьмя отверстиями под болты по этому эскизуОграничения
Для работы нужны установленный FreeCAD с аддоном FreeCADMCP и запущенный RPC-сервер внутри программы, соединение по умолчанию идет через localhost. MCP-сервер запускается через uv или uvx и требует Python 3.12 и выше. Агент может выполнять произвольный Python-код внутри FreeCAD, поэтому запускать его стоит только с проверенными запросами.
Как отключить. Удалите сервер из конфигурации MCP клиента и удалите аддон FreeCADMCP из каталога аддонов FreeCAD.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Выполняет произвольный Python-код внутри FreeCAD
- Создает и меняет документы и модели в приложении на хосте
Коротко о README
README описывает MCP-сервер для управления FreeCAD из Claude Desktop и других клиентов: создание и правка моделей, запуск скриптов, чтение документов и FEM-анализ. Проект состоит из аддона, который поднимает RPC-сервер внутри FreeCAD, и MCP-сервера, который запускается через uvx. В быстром старте показано, как склонировать репозиторий, скопировать аддон, запустить RPC-сервер и добавить сервер freecad в конфигурацию клиента. Отдельные руководства покрывают установку, конфигурацию, инструменты, выполнение кода и примеры. Лицензия MIT.
Частые вопросы
Что должно быть запущено, чтобы сервер работал?
FreeCAD с установленным аддоном FreeCADMCP и запущенным RPC-сервером через кнопку Start RPC Server в панели FreeCAD MCP.
С какими клиентами он работает?
С Claude Desktop и другими MCP-клиентами. В репозитории также есть примеры интеграции с ADK и LangChain.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub