SolidCraft-cli mcpАгенти покрећу исте команде мотора као и трака за алате, скрипте и ЦЛИ – креирају скице, карактеристике, постављају параметре, мере, снимак екрана, извозе STEP/STL, undo/redo – без отварања дијалога.
127.0.0.1:27878(или следећи слободни порт до 27893). Искључите их у Преференције › Асистент › "Дозволите АИ агентима да се повежу (контролни канал / МЦП)" ако желите.# Headless
SolidCraft-cli mcp
# Headless from a design or script
SolidCraft-cli mcp --in part.sc
# 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
На Снап инсталира ЦЛИ јеSolidCraft.cliАпликација пише изабрани порт наcontrol/current.portу својој фасцикли података;--control / SolidCraft_CONTROL_PORTJoš uvek preteruje.
SolidCraft_CONTROL_TOKENпреко--tokenприликом мостовања - аргс командне линије су видљиви у листи процеса (званични доцс).Најбржи пут је у апликацији:Pomoć › Connect AI Assistants...Од терминала (саSolidCraft-cliдоступна — погледајте ПАТХ белешке испод):
SolidCraft-cli mcp setup # every client found on this computer
SolidCraft-cli mcp setup --dry-run # show what it would write, change nothing
SolidCraft-cli mcp setup --client opencode --live
mcp installAli je alias zamcp setupKomanda piše aSolidCraftСервер улаз користећиПуни путОд оSolidCraft-cliкоји га је покренуо, тако да клијенту није потребан тај бинарниPATHКлијент се рачуна као инсталиран када његова конфиг фасцикла већ постоји; инсталација не покреће клијентску апликацију.<name>.bakпрво, непознате датотеке остају саме, а касније поновно покретање након ажурирања само освежава пут уноса који је написао (уноси које је корисник уредио остају као што сте их напустили).--liveДодајеSolidCraft-live, који прелази на отворену апликацију на порту 7878. Поново покрените клијента касније.
od0.22.1, на нормалном покретању апликација може то учинити и сама: додаје или освежаваSolidCraftMCP улаз за сваки инсталиран клијент (Клод Десктоп и Клод Цоде, Кодекс, ОпенЦоде, Гемини ЦЛИ, Цопилот ЦЛИ, Курсор, ВС Цоде, Виндсурф и Зед) и кратко извештава које је повезао. Не преписује уносе које сте уређивали.Подешавања › Асистент › Направите СолидЦрафт доступним за АИ апликације на овом рачунару— који уклања ставке које је додао. Аутоматизација ради (--controlилиSolidCraft_CONTROL_PORT) оставите своје клијенте сами. Помоћ › Повежите АИ асистенте ... иSolidCraft-cli mcp setupОстаните на експлицитним путевима када желите сами да конфигуришете клијенте; аутоматска веза у време покретања је комплементарна, осим ако је онемогућите.
Подржана--clientvrednosti i gde pišu:
--client | Конфигурација фајла |
|---|---|
opencode | ~/.config/opencode/opencode.json(или.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, и Microsoft Store пакета фасцикле |
claude-code | ~/.claude.jsonКориснички опсегmcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEили~/.codex, config.toml(ЦЛИ, ИДЕ екстензија, десктоп) |
gemini | ~/.gemini/settings.json |
copilot | ~/.copilot/mcp-config.jsonGitHub Copilot CLI) |
windsurf | ~/.codeium/windsurf/mcp_config.json |
zed | ЗЕДsettings.json (context_servers) |
vscode | Код корисникаmcp.json |
OpenCode, Gemini, Copilot CLI, Windsurf, Zed и VS Code могу користити истуmcp setup --client …Ручни ОпенЦоде улазни облик (када уређујете ручно):
{
"mcp": {
"SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
}
}
SolidCraft-cliЗа МЦПВећина паковањаSolidCraft-cliјеPATHPošto 0.22.1 pokriva fasciklu Windows Installer, macOS aplikacija (povezuje se na/opt/homebrew/binили/usr/local/bin) и AppImage (мали лансер у~/.local/binна првом покретању), плус deb/rpm/FreeBSD у/usr/binи Хомебрев Каск. два остати даљеPATHПо дизајну: Snap exposesSolidCraft.cliFlatpak trčiflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftКористите их као клијентеcommandсаmcpAppImage улазна тачка је и даље GUI; екстракцијаSolidCraft-cliод squashfs остаје валидна алтернатива. Проверени кораци и конфигурације клијента:
Из званичног МЦП доц:
claude mcp add SolidCraft -- SolidCraft-cli mcp
ili projekat.mcp.json:
{
"mcpServers": {
"SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
}
}
Са контролним каналом и МЦП-ом подразумевано укљученим (0.21.0+, поновљено преко 0.30.0), покрените апликацију нормално, а затим укажите на Клод Десктоп на голуmcp(нађе покренуту апликацију). Након инсталације нормалног пакета,SolidCraft-cliОбично је наPATHбило где од 0.22.1 (Windows инсталатер; macOS апликација; AppImage~/.local/binлансер након првог покретања; плус деб / рпм / ФрееБСД и Хомебрев) - поново покрените клијент тако да покупи новиPATHАко терминал не може да га пронађе (типично за старије Виндовс инсталаторе), прођите кроз пун пут, на примерC:\Program Files\SolidCraft\SolidCraft-cli.exeЗа употребу СнапSolidCraft.cli; за коришћење Flatpakflatpakса аргинимаrun --command=SolidCraft-cli io.tangencylabs.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.
Кодекс подржаваSolidCraft-cli mcp setup --client codex(конфигурисати под$CODEX_HOMEили~/.codex, config.toml) Такође можете пратитиOpenAI Codex MCP документација: Codex држи МЦП сервере у~/.codex/config.toml(ili neki projekat.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"]
Унутар Кодекс терминала УИ,/mcpprikazuje aktivne servere. Koristite ceo put do binarnog akoSolidCraft-cliније на путу (Снап:SolidCraft.cli• Флатпак:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: први покретач у~/.local/binили видиГде живи ЦЛИОдвојено, у апликацији СолидЦрафтАгент Цхатпанел може покренути Цодекс крозnpm install -g @agentclientprotocol/codex-acp(Службени доцс
Курсор је подржан од странеSolidCraft-cli mcp setup --client cursor(Писање~/.cursor/mcp.jsonРучна конфигурација облика испод следиКурсорска документација (.cursor/mcp.jsonили~/.cursor/mcp.jsonНакон подешавања или ручног уређивања, поново учитајте и потврдите да се алати појављују у МЦП подешавањима Курсора.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Користите пуни пут до бинарног ако курсор не може да пронађеSolidCraft-cliНа путу. за Снап:SolidCraft.cliZa Flatpak:flatpakсаrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| алат | улога |
|---|---|
list_commands | Каталог порука |
describe_command | Параметар доцс за једну команду; ЈСОН шеме за његов унос и резултат где команда има уговор који је уписан (само за читање) |
execute / batch | покрените команде за моделирање;batchМоже се вратити на грешке и извештајеrolled_back, undone, appliedиnot_runОпционоcoalesce_parameters(подразумевано лажно) спаја узастопне уређивања обичних параметара тако да се дизајн поново гради једном по покретању (један одступајући корак; сваки корак задржаваcoalescedдужине трајања)timings: trueдодаје по кораку и укупне милисекунде;profile: trueдодаје кернел булеан / теселат / друге поделе где га апликација подржава;verbose: falseзадржава велике дизајнерске одговоре мање. Оба алата такође прихватају опционалнеexpectДве тврдњеvolume_mm3 / bodies / bboxPosle uspešnog rada (relativnotolподразумевано 0.002; bbox координате унутар 0.05 mm); одговор добијаexpectation (ok, измерено, очекивано, несагласност); несагласност се састојиisError: trueали задржава дизајн (немогуће), неважећиexpectOdbija se pre nego što se nešto pokrene.expectје аргумент за алат, а не кључ за корак у серији. Неки алати се могу назвати корацима;screenshot, body_topology, batch, check_parameters, pending, runningиskill_referenceNe može i ne možecomponent.edit_in_placeилиcomponent.finish_editПошаљите их сами са собомexecuteПартија такође не успева пре него што се нешто пошаље када би корак сигурно био одбијен на свој ред (#5853): корак без команде, непознати командни идентификатор (грешка назива најближе идентификаторе), или - са--param-check strictСесија без главе то проверава сама; када је мост, апликација која проверава на сопственом нивоу захтева проверава своје команде када прима партију (сервер тражи једном по повезивању прекоcontrol.capabilities / param_check); старија апликација се проверава на серверу против уговора сервера пре слања (наstrict, ништа што крши уговор се шаље) |
inspect_design / measure / body_topology | читање геометрије и временске линије;inspect_designtakođe liste udruženja (isključite se sajoints: false) |
set_parameter | Креирање / мењање параметара и поновно израчунавање |
check_parameters | Покушајте параметарске вредности без задржавања: једанedit.checkpointПоставите сваку вредност у једанparameters.change {changes}(један реконструисати), прочитајте изабране извештаје, затимedit.restore_checkpointтако да се дизајн, параметри и историја уништавања подударају са оним што су били.set: {name: value}(број или израз сваки, исто као иset_parameter» Сvalue2) Опционоreport? (measure, cylinders, errors; default all three). odgovor uključujevalues, recomputed, measure, errors/warnings(Вишеparameter_errors), cylinders(цилиндрична лица коализована) иrestored: trueГрешке на непознатим именима параметара, лоше вредности или неуспјешно враћање (restored: false + restore_error; испробане вредности могу и даље бити у дизајну).set_parameter→measure→body_topology→set_parameterПовратак, а неbatchПромењује дизајн непоколебљиво, а затим га враћа - не само за читање, не деструктивно (заједно саset_parameter/undo/redo; new_designостаје деструктивна) |
screenshot | ПНГ модела или прозора |
export | СТЕП, 3МФ, СТЛ, ОБЈ, УРДФ, ... |
open / save / new_design | Животни циклус документа |
undo / redo | Историја |
crash_reports | Листа извештаја о несрећи овог рачунара, или отворите један по ид (бацктраце и недавне команде) |
skill_reference | Прочитајте пакет документа о вештинама (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting2) Опционоfile(недостатакreference.md). само за читање; користи агент цхат када су алати за датотеке искључени (од 0.21.0).initializeи агент цхат систем напоменути управљачки агенти овде прво |
running | Покажите шта је апликација заузета са или је у реду за сваког повезаног клијента (без параметара); одговара чак и док је апликација заузета, па га проверите након временског прекида пре преношења промене (од 0.18.3) |
pending | Мод моста: након дугог захтева за контролу враћа "и даље ради", сачекајте до 60 с за тај резултат (done: falseдок се трчи;pending: nullкад ништа не чека). само читање, саrunning, skill_referenceиcrash_reports |
Читање само против немогуће: skill_reference, crash_reports, pendingиrunningТо је само читање.set_parameter, undo, redoиcheck_parametersПромените дизајн необуздано (check_parametersOnda se vrati – ne samo čitajući, ne i destruktivno.new_designзамењује дизајн (деструктивни)
Захтеви за дуготрајну употребу (бридгед):сервер може блокирати до око 300 с на спорој контролној позиви; поставите МЦП клијента временски временски период изнад 330 с. Ако позив истекне или врати "и даље ради", немојте поново послати исту промену - позивpendingи / илиrunning(илиinspect_design) Прво
Агенти могу поставити исту контролу за потврђивање у углу погледа путемui.prefsкључview_confirm_corner(Понекад је то лажно)
За преференције › Навигација › 3Д мишаапликација уређаја на овом рачунарумост, агенти могу поставитиui.prefsкључевиnav_bridge_enabled(подразумевано лажно) иnav_bridge_port(подразумевано 8765). Извор:доцс/3д-мус.мдиПринтер Доцс.
Агенти могу подесити Преференције › НавигацијаПрава орбитапутемui.prefsкључright_drag_orbits(подразумевано истинито; лажно оставља камеру само на десном превлачењу пресетања миша би иначе орбитирало).Принтер Доцс.
Агенти могу подесити Преференције › Навигациони трацкпад зум са кључем путемui.prefsкључtrackpad_zoom_modifier (offнеисправности ;cmd, alt, илиctrl— држите тај кључ сам, тако да вертикални дво прста зуми.Принтер Доцс.
Агенти могу подесити Преференције › Дизајн Асамблеја преместите прекоui.prefsкључевиassembly_move_handles(подразумевано истинито; лажно задржава претходни панел за кретање),joint_rotation_coarse(подразумевано 10°) иjoint_rotation_fine(подразумевано 0.1°) Извор:Принтер Доцс.
Агенти могу подесити Преференције › ИнтерфејсБрзо мерењепутемui.prefsкључquick_measure(подразумевано лажно) Извор:Принтер Доцс.
Агенти могу подесити Преференције › Скетцх & селекцијаИзаберите скривену геометрију са Изаберите другупутемui.prefsкључselect_other_hidden(подразумевано истинито; лажно враћа видљиво-само испод показивача).Принтер Доцс.
Агенти могу управљати личним правилима профила прекоui.prefsкључpersonal_sheet_rulesи командујеsheet.manage_rulesза УИ менаџера). извор:Принтер Доцс.
Агенти и скрипти могу да управљају истим Преференције › Опште › Подешавања профила прекоsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportиsettings.profile.import(Извоз / увоз користитеSolidCraft-profile/1формат документа). Ово су команде мотора крозexecute, не улазе у табелу МЦП протокола алата горе.Извор:Принтер Доцс.
Агенти могу да провере да ли се отворени дизајн променио без поновног читања тако што ће покренутиdocument.revisionКрозexecute• Odgovor je{document_id, revision} — revisionсамо када се дизајн промени, иdocument_idидентификује отворени документ (други наконnew_designилиopenНа десктоп контроли канала клијент може да позовеcontrol.subscribeједном уместо гласања: прве одговарајуће утакмицеdocument.revision, онда апликација гураdesign.changedDogađaji kad goddocument_idилиrevisionпромене (коализовано на око десет по секунди док се вредности крећу; друга претплата на исту везу је одбијена - питајтеdocument.revisionза садашњу државу). извор:доцс / мцп.мдиПротокол контроле.мд(У складу са дизајном)
Нацрт ограничења и геометрија модела:за случајност, тангент, једнака, паралелна, перпендикуларна, средња тачка (тачка и линија, или средње тачке две линије), концентрична, колинеарна и симетрија, било који од уобичајених аргумената нацрта може уместо тога бити ивица модела{edge: [x,y,z], body?}или вертекс{vertex: [x,y,z], body?}.solidcraft пројекти који у скицу прво; пројекција је наведена уcreatedИзвор :docs.solidcraft.io штампање(Ограничење параметара за команду)
Узроци прехладе (solid.extrude):Избор профила по индексу или по тачки обично чувају криве око тог региона тако да прате уређивање параметара.Када референтна геометрија – на пример, пројектована оштрина лица на којем се налази скица – дели нацртани профил на регионе, избор на том нацртаном профилу и даље узима цео нацртани профил.exact_regions: trueсваки индекс или избор тачке значи тачно регион који назива, поклапајући се са оним што дијалози Ектруде шаљу.docs.solidcraft.io штампање (solid.extrudeпараметара )
Провера параметара (од 0.17.0;SolidCraft-cli runод 0.27.0; мост апликације позива од 0.27.1):у складу са уговором о уговору (describe_commandприказује шеме) се могу проверити када се позову.--param-check off|warn|strictза главу без МЦП сесије (укључујући--inСписак), заSolidCraft-cli run, и — од 0.27.1 — за позиве пребачене на покренуту апликацију:offje default i ne menja ništa,warnпокреће позив, али додаје упозорења као што је вероватно погрешан кључ, иstrictодбија позив и оставља нетакнут дизајн. Када је мост, сервер пита апликацију једном по везама да ли апликација проверава на сопственом нивоу захтева (control.capabilitiesиparam_checkуПротокол контроле.мд) Ако апликација то уради, сваки позив иbatchсе шаље са овим нивоом и апликација проверава своје команде (тако да кључеви новије апликације нису одбијени уговорима старијег сервера).strict, одговор који не каже да је апликација која је проверена на том нивоу грешка (звон можда није проверен - проверите дизајн), а сервер затим проверава следеће позиве.strictне шаље ништа што прекида један; команда без уговора о серверу се не проверава). Са таквом старијом апликацијом, сервер и апликацију држите на истом издању. Да бисте видели на шта је прикључен један спој, покренитеjoint.inspectКрозexecuteИзвор :доцс / мцп.мд.
Пет вештина бундеве агента живе исподskills/У овом репу:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanisms, иSolidCraft-reporting(претвара кориснички проблем у извештај о грешкама: репродукујте га у свежем дизајну, скратите га на минимални командни скрипт, проверите саmeasureи снимак екрана, и претражи постојеће проблеме прво).skill_referenceалат (од 0.21.0) враћа оне пакет доцс без потребе за приступом диску.initializeинструкције управљају повезаним агентима да позовуskill_referenceпрво, затим планирају димензије, граде у неколикоbatchпозива, и проверите сваку фазу саmeasure— СолидЦрафт властити агент цхат систем напомена даје исти показатељ.Документи такође документују мостpendingиrunningалати (21 алати укупно са undo/redo рачунати одвојено;runningпреусмерено преко 0.30.0). Још увек у 0.30.0: опционалноexpectјеexecute/batch, check_parameters, и иницирајте смернице да позоветеskill_referenceПрво, писање у 0.30.0 додајеassembly.mass_properties; select.setможе узети лице или ивицу по свету-мм тачки или индексу;document.inspectОд 0.24.0 ин-апп агент цхат приказује позиве алата као обичне резиме (детаљи један клик далеко). Од 0.23.0 ин-апп АИ асистент прво бира провајдера, затим његов модел.
Десктоп помоћник може да покрене отворени дизајн са моделом који ради на вашем рачунару прекоОлга, ЛМ Студио, или други сервер који је компатибилан са ОпенАИ. Потребан вам је модел саnative tool позивање(на Оллама, потражите заtoolsспособност) и довољно ВРАМ за модел плус његов контекст. подршка алатима не гарантује добре резултате.
Постављање :покрените сервер и учитајте модел → Преференције › АИ › Додај агента... › ОпенАИ-компатибилни АПИ → изаберите Оллама, ЛМ Студио, или прилагођени УРЛ → унесите основни УРЛ (нпр.http://localhost:11434/v1за Оллама) и име модела → Тест, затим додајте → отворите помоћника, изаберите крајњу тачку и поставите дозволе (Аск / Едити / Сви).
Који модели раде?Локални модели који могу да користе алате су веома различити. Службени мерени резултати (стандардни тест v1) живе уGitHub проблем #4851— проверите ту табелу за тренутне пролазне бројеве уместо да копирате застарелу листу. У широком смислу, мањи модели који могу да користе алате у класи ВРАМ од ~ 8 ГБ могу да раде; већи модели често постижу већи резултат.
Решавање проблема (на високом нивоу):одговори који су ЈСОН или код, али не мењају ништа обично значи слаб позив алата - пробајте још један модел из #4851. ХТТП 400 "не подржава алата" значи изабрати модел који је способан за алата.num_ctxСпори одговори често значе да се модел пребацује са ВРАМ-а на ЦПУ - пробајте мањи модел или квантизацију.SolidCraft-cli bench-assistantOd 0.23.1 Asistent takođe upozorava u UI kada se okret završi bez korišćenja SolidCraft alatki i kada Ollama model nema podršku za alatke.
Званично писање :Агент Цхат(Секција локалних модела) и#4851.
Подразумевано, алати само додирују:
--inдизајн, дизајн отворен у апликацији, или шта год је агент последњи пут отворио или сачувао - само када се та фасцикла налази стриктно унутар ваше куће или темп фасцикле (не сама кућа, не родитељ као што је/или/Users, не скривене фасцикле). скривене датотеке у тој фасцикли (.env, .gitda ostaneš van dosega,open/save, илиdoc.open/file.save/file.save_asпутемexecute/batchса пуним путем), и без главе сваку фасциклу дизајн је отворен у, док сервер зауставља (до 16 најновије). фасциклу се придружује само након успешног отварања или сачувања у њој – именовање пута није довољно.--allow-path DIRдодајете (та датотека је доступна у потпуности, укључујући скривене датотеке).Radna fascikla u kojoj je server pokrenut ne računa sama po sebi, tako da home dotfiles kao što su~/.sshBudite van dosega, osim ako im to ne dozvolite.
SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathуклања ограничење (претходно понашање) – користите пажљиво.
Када аsave(или било који други позив) је одбијен са "изнад фасцикла које овај агент може користити", додајте фасциклу на сервер МЦП клијентаargsса--allow-pathили поновно покретањеSolidCraft-cli mcp setupнакон уређивања), а затим поново покрените клијента. агент би требало да вас замоли да то урадите уместо да сачувате кроз контролни порт апликације, који игнорише ове границе фасцикле.
У модификованом режиму сервер шаљеallow_pathsи оне отворене / сачуване фасцикле каоdesign_foldersса сваким захтевом (видиПротокол контроле.мд); апликација такође додаје своју фасциклу за опоравак и фасциклу за дизајн који се отвара у њој под истим правилима - преферирају апсолутне путеве.доцс / мцп.мд.
Концептуални ток из примерне сесије званичног доктора:
batchскица правоугаоник → екструдирање → филет → резање рупеmeasureОбласт / Volumescreenshotсаview: "iso"exportna put unutar dozvoljene fascikleДемо сценарије :примери/демо/укључивање_mcp.pyКреирамо уређај преко МЦП.
Такође погледајте:CAD MCP сервери у поређењу · Инсталирање водича · Примери.