FreeCAD MCP: моделирование в FreeCAD через Claude, Codex и Cursor

neka-nat/freecad-mcp· Проверено 12.11.2026· 3,3 тыс.на GitHub

Связывает агента с открытым FreeCAD: создать и изменить модель, выполнить Python-скрипт, снять вид и посчитать нагрузку методом конечных элементов. Два проекта: аддон neka-nat и Robust MCP Server на 150+ инструментов.

2 реализации:

Аддон в FreeCAD и сервер через uvx: 17 инструментов, Python в GUI, в фоне и в отдельном freecadcmd, расчёт FEM в CalculiX; лицензия MIT.

Как подключить

Что сделать до подключения

FreeCAD и uv / uvx; сам сервер работает на Python 3.12 или новее

Папка addon/FreeCADMCP из репозитория, скопированная в каталог Mod вашего FreeCAD, затем перезапуск FreeCAD

В FreeCAD — верстак MCP Addon и кнопка Start RPC Server на панели FreeCAD MCP; сервер слушает 127.0.0.1:9875

FREECAD_MCP_TOKEN

необязателен: нужен, если в аддоне задан токен кнопкой Set Auth Token, например для доступа с другого компьютера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio freecad \
  -- uvx freecad-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.freecad]
command = "uvx"
args = ["freecad-mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "freecad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "freecad": {
        "type": "local",
        "command": ["uvx", "freecad-mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

create_documentсоздаёт документ

list_documentsперечисляет открытые документы

reload_documentпереоткрывает документ с диска

create_objectсоздаёт объект

edit_objectменяет свойства объекта

delete_objectудаляет объект

get_objectsперечисляет объекты документа

get_objectпоказывает один объект

get_viewделает снимок активного вида

execute_codeвыполняет Python в FreeCAD

execute_code_asyncзапускает расчёт в фоне

get_async_statusпоказывает состояние фоновой задачи

execute_code_headlessвыполняет скрипт в freecadcmd

get_rpc_statusпроверяет связь и версию аддона

insert_part_from_libraryвставляет деталь из библиотеки

get_parts_listперечисляет детали библиотеки

run_fem_analysisзапускает расчёт CalculiX

Пакет freecad-robust-mcp и верстак Robust MCP Bridge: 150+ инструментов для PartDesign, булевых операций, экспорта и макросов, запуск произвольного Python и макросов по умолчанию выключен; лицензия Apache-2.0.

Как подключить

Что сделать до подключения

FreeCAD 1.0.2 или новее, для безопасности рекомендован 1.1.4; Python 3.11 или новее

Сервер: pip install freecad-robust-mcp

Верстак Robust MCP Bridge из архива релиза по инструкции установки, в каталоге Addon Manager его нет

Сопряжение под тем же пользователем ОС: freecad-mcp --pair-bridge, затем Start MCP Bridge на панели верстака; сервер и верстак версии 0.7.0 или новее

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env FREECAD_MODE=xmlrpc --transport stdio freecad-addon-robust-mcp-server \
  -- freecad-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.freecad-addon-robust-mcp-server]
command = "freecad-mcp"
args = []

[mcp_servers.freecad-addon-robust-mcp-server.env]
FREECAD_MODE = "xmlrpc"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "type": "stdio",
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "freecad-addon-robust-mcp-server": {
        "type": "local",
        "command": ["freecad-mcp"],
        "environment": {
          "FREECAD_MODE": "xmlrpc"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "freecad-addon-robust-mcp-server": {
      "command": "freecad-mcp",
      "args": [],
      "env": {
        "FREECAD_MODE": "xmlrpc"
      }
    }
  }
}

Инструменты сервера

create_documentсоздаёт документ

open_documentоткрывает файл .FCStd

save_documentсохраняет документ

create_boxсоздаёт параллелепипед

create_cylinderсоздаёт цилиндр

boolean_operationобъединяет, вычитает, пересекает

set_placementзадаёт положение и поворот

create_partdesign_bodyсоздаёт тело PartDesign

create_sketchсоздаёт эскиз

add_sketch_rectangleдобавляет прямоугольник в эскиз

pad_sketchвыдавливает эскиз

pocket_sketchвырезает карман по эскизу

create_holeсоздаёт отверстие с резьбой

fillet_edgesскругляет рёбра

polar_patternразмножает элемент по кругу

get_screenshotснимает 3D-вид

export_stepэкспортирует в STEP

export_stlэкспортирует в STL

create_macro_from_templateсоздаёт макрос по шаблону

undoотменяет последнее действие

Что попросить агента

«Создай фланец диаметром <мм> с <N> отверстиями под болты»Агент создаст документ через create_document, построит деталь через create_object или execute_code и проверит результат снимком get_view

«Построй деталь по этому чертежу <файл>»Агент разберёт размеры и построит модель через create_object и edit_object, по пути проверяя вид get_view

«Посчитай консольную балку <длина> мм под нагрузкой <сила> N и покажи напряжения»Агент подготовит анализ через execute_code и запустит run_fem_analysis, вернёт напряжение по Мизесу и перемещения

«Вставь из библиотеки <деталь> и поставь её на <место>»Агент найдёт деталь через get_parts_list и вставит её через insert_part_from_library

«Сделай коробку <размеры> со скруглёнными рёбрами и сохрани в STL»В Robust MCP Server агент вызовет create_box, fillet_edges и export_stl

Для каких задач

Построить деталь по словесному заданию или по 2D-чертежу: эскиз, выдавливание, отверстия, скругления

Выполнить Python-скрипт внутри FreeCAD или в отдельном процессе freecadcmd

Посчитать нагрузку на деталь в CalculiX и получить максимальное напряжение по Мизесу и перемещения

Вставить готовую деталь из библиотеки FreeCAD

Экспортировать модель в STEP, STL или 3MF для обмена и 3D-печати

Создать макрос FreeCAD по шаблону и прочитать исходник существующего

Ограничения

RPC-сервер аддона neka-nat без токена принимает вызовы от любого, кто достучится до порта, и execute_code выполняет любой Python с вашими правами; доступ с другого компьютера включайте с токеном или через SSH-туннель

У neka-nat операции в окне FreeCAD идут по одной, execute_code по умолчанию ждёт 90 секунд, а начатую задачу отменить нельзя

У Robust MCP Server снимки и вид недоступны без окна FreeCAD, режим embedded работает только на Linux, а контейнер Docker на Linux до FreeCAD не достучится

Аддон и сервер в обоих проектах обновляются по отдельности, и версии нужно держать совместимыми

Если не работает

После копирования аддона нет верстака MCP Addon

В каталоге Mod должен лежать FreeCADMCP/InitGui.py без лишнего уровня папок, весь репозиторий копировать не нужно. Ошибки импорта видны в View → Panels → Report view.

Ответ инструмента начинается с предупреждения о версии

Аддон и пакет freecad-mcp разошлись по версиям; предупреждение называет, что обновить. После обновления аддона перезапустите FreeCAD.

execute_code пишет про таймаут, а работа продолжается

Начатую задачу в окне FreeCAD отменить нельзя, её результат отбрасывается. Передайте timeout до 1800 секунд или вынесите тяжёлую геометрию в execute_code_async.

Все операции отвечают GUI_DISPATCH_STUCK

Операция превысила своё время и заняла поток окна. Узнайте, какая, через get_rpc_status из отдельного клиента и дождитесь её окончания.

Robust MCP Server в Docker на Linux не видит FreeCAD

Мост слушает только loopback, а Docker Engine на Linux туда не достаёт. Запустите сервер прямо на хосте.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
FreeCAD MCP	neka-nat	3,3 тыс.	локально	не нужен	17	12 ноября 2026
FreeCAD Robust MCP Server	spkane	269	локально	не нужен	20	9 ноября 2026

Частые вопросы

Какой вариант выбрать?

FreeCAD MCP от neka-nat ставится быстрее: 17 инструментов, запуск через uvx, расчёт FEM и любой Python-код. Robust MCP Server даёт 150+ готовых инструментов для эскизов, PartDesign, экспорта и макросов, но требует сопряжения сервера с верстаком.

Куда копировать аддон FreeCADMCP?

В каталог Mod пользователя, например %APPDATA%\FreeCAD\v1-1\Mod\ в Windows для FreeCAD 1.1 или ~/.local/share/FreeCAD/Mod/ в Debian. Точный путь покажет консоль Python в FreeCAD: print(os.path.join(FreeCAD.getUserAppDataDir(), "Mod")).

Как запускать RPC-сервер вместе с FreeCAD?

На верстаке MCP Addon откройте меню FreeCAD MCP и отметьте Auto-Start Server. Настройка сохраняется в freecad_mcp_settings.json, и сервер стартует при каждом запуске FreeCAD.

Как сэкономить токены на скриншотах?

Добавьте в args флаг --only-text-feedback: инструменты перестанут прикладывать снимки к ответам. Снимок по запросу по-прежнему делает get_view, а в отдельном вызове можно передать include_screenshot: false.

Можно ли управлять FreeCAD на другом компьютере?

Да, у neka-nat: включите Remote Connections и список Allowed IPs в аддоне, задайте токен, а серверу передайте --host с адресом машины и FREECAD_MCP_TOKEN. В чужой сети надёжнее SSH-туннель на порт 9875.

Где скачать FreeCAD MCP?

Аддон neka-nat берётся из репозитория: git clone https://github.com/neka-nat/freecad-mcp.git, папка addon/FreeCADMCP. Сервер скачивать не нужно, его запускает uvx freecad-mcp. Robust MCP Server ставится через pip install freecad-robust-mcp, верстак — из архива релиза.

Как подключить FreeCAD MCP к Claude Desktop?

Добавьте в claude_desktop_config.json сервер freecad с командой uvx и аргументом freecad-mcp, перезапустите Claude Desktop и держите FreeCAD открытым с запущенным RPC-сервером. Конфиги других клиентов — во вкладках блока «Как подключить».

Работает ли сервер из России?

Оба сервера работают на вашем компьютере рядом с FreeCAD, ключи и зарубежные аккаунты не нужны.

FreeCAD MCP: моделирование в FreeCAD через Claude, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы