solidcraft-cli mcpАгенты выполняют те же команды двигателя, что и панель инструментов, скрипты и CLI — создавать эскизы, функции, устанавливать параметры, измерять, снимать экран, экспортировать STEP/STL, undo/redo — без открытия диалогов.
127.0.0.1:27878(или следующий свободный порт до 27893). выключите их в Настройки › Ассистент › «Позвольте агентам ИИ подключиться (контрольный канал / MCP)», если вы предпочитаете.# Headless
solidcraft-cli mcp
# Headless from a design or script
solidcraft-cli mcp --in part.solidcraft
# Bridged: app listens by default — bare mcp finds it (headless when none runs; --headless forces that)
solidcraft &
solidcraft-cli mcp
# Fixed port / second app
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
На Snap устанавливается CLIsolidcraft.cliПриложение записывает выбранный порт наcontrol/current.portв своей папке данных;--control / SOLIDCRAFT_CONTROL_PORTВсе еще опережают.
SOLIDCRAFT_CONTROL_TOKENнад--tokenпри мостировании — args командной строки видны в списке процессов (официальных документах).solidcraft-cli для MCPБольшинство пакетов после установки кладут solidcraft-cli в PATH (папка установщика Windows; deb/rpm/FreeBSD в /usr/bin; Homebrew cask; AppImage при первом запуске пишет небольшой лаунчер в ~/.local/bin; приложение macOS линкует в /opt/homebrew/bin или /usr/local/bin). Два намеренно остаются вне PATH: Snap даёт solidcraft.cli, Flatpak — flatpak run --command=solidcraft-cli ai.storyteller.solidcraft — используйте это как command клиента с аргументом mcp. Точка входа AppImage по-прежнему GUI; извлечение solidcraft-cli из squashfs остаётся допустимой альтернативой. Проверенные шаги и конфиги клиентов:
Из официального доклада MCP:
claude mcp add solidcraft -- solidcraft-cli mcp
или проект.mcp.json:
{
"mcpServers": {
"solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
}
}
При включённых по умолчанию канале управления и MCP (0.21.0+, снова в 0.22.0) запустите приложение как обычно и укажите Claude Desktop просто mcp (он найдёт работающее приложение). После обычной установки пакета solidcraft-cli обычно уже в PATH (папка установщика Windows; deb/rpm/FreeBSD; Homebrew; лаунчер AppImage в ~/.local/bin после первого запуска; ссылка приложения macOS) — перезапустите клиент, чтобы он подхватил новый PATH. Для Snap: solidcraft.cli; для Flatpak: flatpak с аргументами run --command=solidcraft-cli ai.storyteller.solidcraft mcp (или задайте command/args). Официальный пример с фиксированным портом для claude_desktop_config.json по-прежнему работает, если указать порт:
{
"mcpServers": {
"solidcraft": {
"command": "/path/to/solidcraft-cli",
"args": ["mcp"]
}
}
}
Для фиксированного порта:args: ["mcp", "--connect", "127.0.0.1:7878"]Запустите приложение сsolidcraft --control 7878.
~/.codex/config.toml(или проект.codex/config.tomlв доверенных проектах), совместно с Codex CLI, расширением IDE и настольным приложением.Добавьте сервер без головы с одной командой:
codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list # check it is registered
или Edit~/.codex/config.tomlвручную, например, чтобы перейти к запущенному приложению и разрешить папку дизайнов:
[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
В терминальном UI Codex команда /mcp показывает активные серверы. Если solidcraft-cli нет в PATH, укажите полный путь к бинарнику (Snap: solidcraft.cli; Flatpak: flatpak run --command=solidcraft-cli ai.storyteller.solidcraft; AppImage: лаунчер после первого запуска в ~/.local/bin или см. где лежит CLI). Отдельно панель Agent chat в приложении может запускать Codex через npm install -g @agentclientprotocol/codex-acp (официальная документация).
.cursor/mcp.jsonили~/.cursor/mcp.jsonПроверка инструментов появляется в настройках MCP курсора после перезагрузки.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Укажите полный путь к бинарнику, если Cursor не находит solidcraft-cli в PATH. Для Snap: solidcraft.cli. Для Flatpak: flatpak с run --command=solidcraft-cli ai.storyteller.solidcraft mcp.
| инструмент | Роль |
|---|---|
list_commands | Каталог команд |
describe_command | Parameter docs for one command; JSON Schemes for its input and result where the command has a typed contract (только для чтения) |
execute / batch | Выполняет команды моделирования; batch может откатить при ошибке и сообщает rolled_back, undone, applied и not_run. Опция coalesce_parameters (по умолчанию false) объединяет подряд идущие обычные правки параметров, чтобы дизайн пересобирался один раз за прогон (один шаг undo; у каждого шага сохраняется длина прогона coalesced). Некоторые инструменты можно называть шагами; screenshot, body_topology, batch, pending, running и skill_reference — нельзя |
inspect_design / measure / body_topology | Читать геометрию и временную линию;inspect_designтакже перечисляет соединения ассамблеи (отключить сjoints: false) |
set_parameter | Создание/изменение параметров и восстановление |
screenshot | PNG модели или окна |
export | STEP, 3MF, STL, OBJ, URDF и др. |
open / save / new_design | Жизненный цикл документа |
undo / redo | История |
crash_reports | Перечислите отчеты об авариях этого компьютера или откройте их по id (backtrace и недавние команды) |
skill_reference | Прочитайте пакетный документ о навыках (solidcraft-modeling, solidcraft-mechanisms, solidcraft-editing, solidcraft-checking• опциональныйfile(недостаткиreference.mdЛишь для чтения; используется агентским чатом, когда файловые инструменты отключены (с 0.21.0) |
running | Показать, что приложение занято или в очереди для каждого подключенного клиента (без параметров); отвечает даже тогда, когда приложение занято, поэтому проверьте его после отключения времени, прежде чем пересылать изменение (с 0.18.3) |
pending | Модульный режим: после долгого контрольного запроса возвращается «все еще работает», подождите до 60 с для этого результата (done: falseкогда он бежит;pending: nullкогда ничего не ждет) только читать, сrunning, skill_referenceиcrash_reports |
Долгосрочные запросы (по мосту):сервер может блокировать до 300 с при медленном контрольном вызове; установите временной промежуток MCP-клиента выше 330 с. Если вызов заканчивается или возвращается «все еще работает», не пересылайте одно и то же изменение — вызовpendingи/илиrunning(илиinspect_design) сначала
Проверка параметров (с момента 0.17.0):команд с типированным контрактом (покаsolid.box, solid.extrudeиengine.describe) могут быть проверены при их вызове, иdescribe_commandпоказывает свои схемы. Начните бесконечную сессию с--param-check off|warn|strict: offОн не изменяет и не изменяет.warnзапускает вызов, но добавляет предупреждения, такие как вероятный ошибочный ключ, иstrictотклоняет вызов и оставляет дизайн нетронутым. Вызовы, перенаправленные на запущенное приложение, еще не проверяются. Чтобы увидеть, к чему прикреплено одно соединение, запуститеjoint.inspectЧерезexecute• Источник:docs/mcp.md в версии v0.17.0.
Факультативные навыки агента живут подskills/в репродуктивном (solidcraft-modeling, solidcraft-editingИ т. д. МКБskill_referenceинструмент (с 0.21.0) возвращает эти упакованные документы без необходимости доступа к диску; документы также документируютpendingинструмент (19 инструментов в общей сложности с отсчётом undo/redo отдельно; без изменений в 0.22.0).
По умолчанию инструменты только касаются:
--allow-path DIRВы добавляетеsolidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathУстраняет предел (предыдущее поведение) — используйте с осторожностью.
Концептуальный поток из примерной сессии официального доктора:
batcha sketch прямоугольник → экструд → филет → cut a holemeasureОбъем / Площадьscreenshotсview: "iso"exportДойти до пути внутри разрешенной папкиДемо скрипты :примеры/демо/включение_mcp.pyСоздание оболочки через MCP.
Так же смотрите:CAD MCP серверы по сравнению · Инсталляционный гид · Примеры.