SolidCraft-cli mcpAz ügynökök ugyanazokat a motorparancsokat futtatják, mint az eszköztár, a szkriptek és a CLI – vázlatokat, funkciókat, beállított paramétereket, mérést, screenshotot, STEP/STL exportot, undo/redo létrehozást – párbeszédek megnyitása nélkül.
127.0.0.1:27878(vagy a következő ingyenes port akár 27893-ig). Kapcsolja ki őket a Beállítások › Asszisztens › „Hagyja, hogy az AI ügynökök csatlakozzanak (vezérlőcsatorna / MCP)” ha úgy tetszik.# 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
A Snap telepíti a CLI-tSolidCraft.cliAz alkalmazás a kiválasztott portot írjacontrol/current.portaz adathordozón belül;--control / SolidCraft_CONTROL_PORTMég mindig túlságosan.
SolidCraft_CONTROL_TOKENfelett--tokena hídolás során – a folyamatok listájában (hivatalos dokumentumok) láthatóak a parancssori argok.A leggyorsabb út az alkalmazásban található:Segítség › Csatlakoztassa az AI asszisztenseket...Egy terminálról (aSolidCraft-clielérhető – lásd a PATH megjegyzéseket alább):
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 installEz egy alias amcp setupA parancs megírja aSolidCraftA kiszolgáló belépése aTeljes útA TheSolidCraft-clihogy futott, így az ügyfélnek nincs szüksége arra a binárisPATHAz ügyfél akkor számít telepítettnek, ha a konfigurációs mappája már létezik; a telepítés nem indítja el az ügyfélalkalmazást.<name>.bakElőször is, az el nem olvasható fájlok egyedül maradnak, és egy későbbi újratöltés egy frissítés után csak frissíti az általa írt bejegyzések útját (a felhasználó által szerkesztett bejegyzések úgy maradnak, ahogy elhagytad őket).--livehozzáadásaSolidCraft-live, amely a port 7878-on megnyitja az alkalmazást. a kliens későbbi újraindítása.
Mivel0.22.1, egy normál indításnál az alkalmazás ezt is megteheti: hozzáadja vagy frissíti aSolidCraftAz MCP-bejegyzés minden telepített klienshez (Claude Desktop és Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf és Zed) és röviden jelentést tesz arról, hogy melyiket csatlakoztatta.Beállítások › Asszisztens › Tegye elérhetővé a SolidCraft-ot az AI-alkalmazások számára ezen a számítógépen– amely eltávolítja a hozzáadott bejegyzéseket. Automatizálás fut (--controlvagySolidCraft_CONTROL_PORTSegítség › Csatlakoztassa az AI asszisztenseket... ésSolidCraft-cli mcp setupTartsa a kifejezett útvonalakat, ha saját maga szeretné konfigurálni a klienseket; a indítási időben történő automatikus csatlakozás kiegészítő, hacsak nem kapcsolja ki.
Támogatott--clientÉrtékek és hol írnak:
--client | Konfigurációs fájl |
|---|---|
opencode | ~/.config/opencode/opencode.json(vagy.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, és a Microsoft Store csomagmappája |
claude-code | ~/.claude.jsonfelhasználói tartománymcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEvagy~/.codex, config.toml(CLI, IDE kiterjesztés, desktop) |
gemini | ~/.gemini/settings.json |
copilot | ~/.copilot/mcp-config.json(GitHub Copilot CLI alkalmazás) |
windsurf | ~/.codeium/windsurf/mcp_config.json |
zed | Zsófisettings.json (context_servers) |
vscode | Kód felhasználómcp.json |
Az OpenCode, a Gemini, a Copilot CLI, a Windsurf, a Zed és a VS Code ugyanazt használhatja.mcp setup --client …Kézi OpenCode-beviteli forma (ha kézzel szerkeszti):
{
"mcp": {
"SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
}
}
SolidCraft-cliAz MCPA legtöbb csomagSolidCraft-cliAzonPATHa telepítés után. mivel a 0.22.1 a Windows telepítő mappát tartalmazza, a macOS alkalmazás (a/opt/homebrew/binvagy/usr/local/binAz AppImage (kis launcher~/.local/binaz első futásnál), plusz deb/rpm/FreeBSD/usr/binHomebrew Cask - Két maradjonPATHTervező: Snap ExposesSolidCraft.cliFlatpak futásflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftHasználja őket, mint az ügyfélcommandAzokkalmcpAz AppImage bemeneti pont továbbra is a GUI; kivonásSolidCraft-clia squashf-ből érvényes alternatíva marad. Ellenőrzött lépések és klienskonfigurációk:
A hivatalos MCP doc:
claude mcp add SolidCraft -- SolidCraft-cli mcp
vagy projekt.mcp.json:
{
"mcpServers": {
"SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
}
}
Ha a vezérlőcsatorna és az MCP alapértelmezés szerint be van kapcsolva (0.21.0+, 0.30.0-on keresztül újraindítva), indítsa el az alkalmazást normálisan, majd mutassa meg a Claude Desktop-ot egy meztelenmcp(megtalálja a futó alkalmazást). A normál csomag telepítése utánSolidCraft-cliÁltalában aPATHmindenhol a 0.22.1 óta (Windows telepítő; macOS alkalmazás; AppImage~/.local/binlauncher az első futás után; plusz deb/rpm/FreeBSD és Homebrew) – indítsa újra az ügyfelet, így felveszi az újPATHHa egy terminál nem tudja megtalálni (ez jellemző a régebbi Windows-telepítőkre), kattintson a teljes útvonalra, példáulC:\Program Files\SolidCraft\SolidCraft-cli.exeSnap használataSolidCraft.cli• Flatpak használataflatpakAz argonokrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(vagy beállításacommand/argshivatalos fix port példa aclaude_desktop_config.jsonMég mindig működik, ha egy portot nevez:
{
"mcpServers": {
"SolidCraft": {
"command": "/path/to/SolidCraft-cli",
"args": ["mcp"]
}
}
}
Állandó kikötő esetén:args: ["mcp", "--connect", "127.0.0.1:7878"]Indítsa el az alkalmazást aSolidCraft --control 7878.
A Codex által támogatottSolidCraft-cli mcp setup --client codex(Config alatt$CODEX_HOMEvagy~/.codex, config.tomlÖn is követhetiOpenAI Codex MCP dokumentációA Codex az MCP-kiszolgálókat~/.codex/config.toml(vagy egy projekt.codex/config.tomlmegbízható projektekben), amelyeket a Codex CLI, az IDE kiterjesztés és az asztali alkalmazás oszt meg.
Adja hozzá a fej nélküli szervert egy parancsra:
codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list # check it is registered
Vagy Edit~/.codex/config.tomlkézzel, például egy futó alkalmazáshoz való csatlakozáshoz és egy tervezési mappához való csatlakozáshoz:
[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
A Codex terminálon belül,/mcpmegjeleníti az aktív szervereket. Használjon teljes bináris útvonalat, haSolidCraft-cliNincs az út mentén (Snap:SolidCraft.cli• Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft· AppImage: első futó launcher~/.local/binVagy lásdAhol a CLI élA SolidCraft alkalmazáson belülChat ügynökA Codex segítségével anpm install -g @agentclientprotocol/codex-acpA hivatalos docs.
Cursor támogatja aSolidCraft-cli mcp setup --client cursor( írása~/.cursor/mcp.jsonA kézi konfiguráció alakja az alábbiak szerintCursor dokumentáció (.cursor/mcp.jsonvagy~/.cursor/mcp.jsonA telepítés vagy a kézi szerkesztés után töltse fel újra és erősítse meg, hogy az eszközök megjelennek a Cursor MCP beállításaiban.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Használjon teljes utat a binárishoz, ha a Cursor nem találjaSolidCraft-cliAz út mentén a Snap:SolidCraft.cliA Flatpak esetében:flatpakAzokkalrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| szerszám | szerepét |
|---|---|
list_commands | katalógus parancs |
describe_command | Paraméterdokumentumok egy parancshoz; JSON Tervek a bemenethez és az eredményhez, ahol a parancsnak van egy beírt szerződése (csak olvasható) |
execute / batch | Modellező parancsok futtatása;batchVisszaállíthatja a hibákat és jelentéseketrolled_back, undone, appliedésnot_runopcionáliscoalesce_parameters(alapértelmezett hamis) egymást követő egyszerű paraméter-szerkesztéseket egyesít, így a tervezés futásonként egyszer újjáépül (egy undo lépés; minden lépés egycoalescedHosszú távolságú futás)timings: truelépésenkénti és teljes milliszekundumokat ad hozzá;profile: truehozzáadja a kernel boolean / tessellate / egyéb felosztásokat, ahol az alkalmazás támogatja;verbose: falsekisebb méretű válaszokat biztosít. mindkét eszköz elfogadja az opcionálisexpectAz állításvolume_mm3 / bodies / bboxA sikeres futás után (relatívtolalapértelmezett 0,002; bbox koordináták belül 0,05 mm); a válasz nyerexpectation (ok, mért, várt, nem egyezik meg); egy nem egyezikisError: truemegtartja a tervet; érvénytelen;expectMielőtt bármi megtörténne, elutasítják.expectegy eszköz argumentum, nem egy tétel lépéskulcs. Egyes eszközöket lépéseknek is nevezhetünk;screenshot, body_topology, batch, check_parameters, pending, runningésskill_referenceNem lehet és nem is lehetcomponent.edit_in_placevagycomponent.finish_edit(Egyedül küldje el aexecuteEgy tétel is kudarcot vall, mielőtt bármi elküldené, ha egy lépést a sorban (#5853) biztosan elutasítanának: egy lépés parancs nélkül, egy ismeretlen parancsazonosító (a hiba a legközelebbi azonosítókat nevezi), vagy - a--param-check strictEgy fej nélküli munkamenet ezt maga ellenőrzi; amikor összekapcsolódik, egy alkalmazás, amely a kérelem saját szintjén ellenőrzi a saját parancsokat, amikor megkapja a tételt (a szerver kapcsolatonként egyszer kér)control.capabilities / param_check); egy régebbi alkalmazás ellenőrzi a szerveren a szerver szerződését a küldés előtt (astrict, semmi, ami megsérti a szerződést küldik) |
inspect_design / measure / body_topology | Geometria és idővonal olvasása;inspect_designa gyülekezet tagjait is felsorolja (ki kell kapcsolni ajoints: false) |
set_parameter | Paraméterek létrehozása/változtatása és újraszámítása |
check_parameters | Próbáld ki a paraméter értékeket anélkül, hogy megtartanád őket: egyedit.checkpointÁllítsa be minden értéket egyparameters.change {changes}(egy újratelepítés), olvassa el a kiválasztott jelentéseket, majdedit.restore_checkpointígy a tervezés, a paraméterek és az undo történelem megegyezik azzal, ami volt.set: {name: value}(a szám vagy kifejezés mindegyike, ugyanúgy mintset_parameter„Svalue• opcionálisreport? (measure, cylinders, errorsVálasz: A válasz tartalmazza avalues, recomputed, measure, errors/warnings(Többparameter_errors), cylinders(Cilindrikus arcok összeolvasztva) ésrestored: trueHibák az ismeretlen paraméterek nevében, rossz értékek, vagy nem sikerült helyreállítani (restored: false + restore_errorA kipróbált értékek még a tervezésben is megtalálhatók.)set_parameter→measure→body_topology→set_parameterVissza, nem abatchMegváltoztatja a tervezést, majd visszaállítja azt – nem csak olvasható, nem pusztító (aset_parameter/undo/redo; new_designtovábbra is pusztító) |
screenshot | A modell vagy ablak PNG-je |
export | STEP, 3MF, STL, OBJ, URDF, ... |
open / save / new_design | Dokumentum életciklus |
undo / redo | történelem |
crash_reports | A számítógép összeomlási jelentéseinek listája, vagy nyissa meg az egyiket id (backtrace és legutóbbi parancsok) |
skill_reference | Olvasd el a csomagolt készség dokumentumot (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting• opcionálisfile(A hiányosságokreference.mdCsak olvasható; az ügynök csevegése használja, ha a fájleszközök kikapcsolva vannak (a 0.21.0 óta).initializeés az ügynök chat rendszer megjegyzi az ügynökök irányítását itt először |
running | Mutasd meg, hogy az alkalmazás minden egyes csatlakoztatott kliensnél (paraméterek nélkül) mit foglalkoztat vagy sorban áll; válaszol még akkor is, ha az alkalmazás elfoglalt, ezért ellenőrizze azt egy időzítés után, mielőtt módosítást küldene (mivel 0.18.3) |
pending | Híd mód: miután egy hosszú vezérlési kérés visszatér "még mindig fut", várjon legfeljebb 60 másodpercet az eredmény eléréséhez (done: falsemiközben fut;pending: nullHa nem, akkor csak olvashatóan,running, skill_referenceéscrash_reports |
Olvasható vs. képtelen: skill_reference, crash_reports, pendingésrunningCsak az olvasó.set_parameter, undo, redoéscheck_parametersmegváltoztatja a tervezést képtelen (check_parametersutólag visszahelyezi – nem csak olvasható, nem pusztító).new_designhelyettesíti a tervezést (destruktív)
Hosszú távú kérések (bridged ) :A szerver akár 300 másodpercig is blokkolhatja a lassú vezérlési hívást; állítsa be az MCP kliens időtartamát 330 másodpercig.pendingés/vagyrunning(vagyinspect_designElőször is
Az ügynökök beállíthatják ugyanazt a nézőpont-megerősítő vezérlést aui.prefskulcsszóview_confirm_corner(A fájl alapértelmezett hibája)
For the Preferences › Navigáció › 3D egéreszköz alkalmazás ezen a számítógépenHíd, ügynökök beállíthatjaui.prefsKulcsoknav_bridge_enabled(az alapértelmezett hamis) ésnav_bridge_port(Alapértelmezés szerint 8765). forrás:docs / 3d egér.mdésNyomtatás Docs.
Az ügynökök beállíthatják a Beállítások › NavigációHelyes orbitális húzásútjánui.prefskulcsszóright_drag_orbits(az alapértelmezett igaz; a hamis a fényképezőgépet egyedül hagyja egy jobbról húzza, az egér előre beállítása máskülönben keringne). forrás:Nyomtatás Docs.
Az ügynökök a Preferences › Navigation trackpad zoom-with-keyui.prefskulcsszótrackpad_zoom_modifier (offaz elmaradás;cmd, altvagyctrl- tartsa ezt a kulcsot egyedül, így a függőleges kétujjú görgető zoom).Nyomtatás Docs.
Az ügynökök beállíthatják a Preferences › Design Assembly Moveui.prefsKulcsokassembly_move_handles(az alapértelmezett true; a false megtartja az előző Move panelt),joint_rotation_coarse(az alapértelmezett 10°) ésjoint_rotation_fine(Az alapértelmezett 0,1°) Forrás:Nyomtatás Docs.
Az ügynökök beállíthatják a Preferences › InterfaceGyors mérésútjánui.prefskulcsszóquick_measure(az alapértelmezés szerint hamis) Forrás:Nyomtatás Docs.
Az ügynökök beállíthatják a Preferences › Sketch & selectionVálassza ki a rejtett geometriát a Válasszon másokatútjánui.prefskulcsszóselect_other_hidden(az alapértelmezett igaz; a hamis helyreállítása csak a mutató alatt látható).Nyomtatás Docs.
Az ügynökök kezelhetik a profil személyes lemezes szabályokat aui.prefskulcsszópersonal_sheet_rules(és a parancssheet.manage_rulesA menedzser forrása:Nyomtatás Docs.
Az ügynökök és a forgatókönyvek ugyanazokat a beállításokat › Általános › Beállítások profilokat kezelhetiksettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportéssettings.profile.import(export / import használja aSolidCraft-profile/1Ezeket a parancsokat a motoron keresztülexecute, nem szerepel a fenti MCP protokoll eszközök táblázatában. forrás:Nyomtatás Docs.
Az ügynökök ellenőrizhetik, hogy a nyitott tervezés megváltozott-e anélkül, hogy újraolvasnákdocument.revisionkeresztülexecuteA válasz az{document_id, revision} — revisioncsak akkor halad előre, ha a tervezés megváltozik, ésdocument_idazonosítja a megnyitott dokumentumot (egy másiknew_designvagyopenAz asztali vezérlőcsatornán egy ügyfél hívhatcontrol.subscribeEgyszer a szavazás helyett: az első válaszokdocument.revisionAz app nyomja megdesign.changedEsemények minden alkalommaldocument_idvagyrevisionváltozások (körülbelül tíz másodpercenként, miközben az értékek folyamatosan mozognak; ugyanazon a kapcsolaton a második előfizetés elutasításra kerül - kérjendocument.revisiona jelenlegi állapotban). forrás:Cimkék / mcp.mdésMűszaki ellenőrzés.md(A tervezés után
A korlátozások és a modellgeometria:A véletlen, a tangens, az egyenlő, a párhuzamos, a függőleges, a középső pont (egy pont és egy vonal, vagy két vonal középső pontja), a koncentrikus, a kollineáris és a szimmetria esetében a szokásos vázlat-argumentumok bármelyike lehet modell szélessége.{edge: [x,y,z], body?}A vertex{vertex: [x,y,z], body?}SolidCraft projektek, amelyek először a vázlatba kerülnek; a vetítés acreatedA forrás:docs.solidcraft.io nyomtatás(A parancsnoki paraméterek korlátozása)
A szűrővizsgálat (solid.extrude):A profilok index vagy pont alapján történő kiválasztásait általában az adott régió körüli görbék tárolják, így továbbra is követik a paraméterek szerkesztését. Amikor a hivatkozási geometria – például a vázlaton ülő arc projektált ábrázolása – felosztja a rajzolt profilt régiókra, a rajzolt profillal történő kiválasztás még mindig az egész rajzolt profilt veszi igénybe.exact_regions: trueminden index vagy pont kiválasztása pontosan azt jelenti, hogy melyik régiót nevezte meg, ami megfelel annak, amit az Extrude párbeszédek küldenek.docs.solidcraft.io nyomtatás (solid.extrudeA paraméterek
A paraméterek ellenőrzése (mivel 0.17.0;SolidCraft-cli runmivel 0.27.0; híd app hívások óta 0.27.1):A szerződéskötés megkötésének módja (describe_commandmegtekinthetők, ha a megkeresés megtörténik. áttekintés--param-check off|warn|stricta fej nélküli MCP munkamenethez (beleértve a--inírásait, mertSolidCraft-cli run, és – a 0.27.1 óta – egy futó alkalmazáshoz kapcsolódó hívások esetén:offnem változik és nem változik,warna hívást futtatja, de figyelmeztetéseket ad hozzá, például egy valószínűleg hibás kulcsot, ésstricta hívást elutasítja, és érintetlenül hagyja a tervezést. A híd esetén a kiszolgáló a kapcsolatonként egyszer megkérdezi az alkalmazást, hogy az alkalmazás ellenőrzi-e a kérés saját szintjét (control.capabilitiesésparam_checkazMűszaki ellenőrzés.md) Ha az alkalmazás ezt teszi, minden hívás ésbatchaz adott szinten küldik, és az alkalmazás saját parancsokkal ellenőrzi (így egy újabb alkalmazás kulcsait nem utasítják el a régebbi szerverek szerződései).strict, a válasz, amely nem mondja, hogy az ezen a szinten ellenőrzött alkalmazás hiba (a hívás ellenőrzés nélkül futhatott - ellenőrizze a tervezést), majd a szerver maga ellenőrzi a következő hívásokat.strictnem küld semmit, ami megszakad; a szerverszerződés nélküli parancs nem ellenőrizhető). Egy ilyen régebbi alkalmazással tartsa a szervert és az alkalmazást ugyanazon a kiadáson.joint.inspectkeresztülexecuteA forrás:Cimkék / mcp.md.
Öt csomagolt ügynöki készség élő alattskills/A repülés során:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsésSolidCraft-reporting(egy felhasználói problémát hibajelentéssé alakít: új formatervezésben reprodukálja, minimális parancsfájlra szűkíti, ellenőrizzemeasureés egy screenshotot, és először keresse meg a meglévő problémákat).skill_referenceAz eszköz (a 0.21.0 óta) visszaadja a csomagolt dokumentumokat anélkül, hogy hozzáférést igényelne a lemezhez.initializeutasítások irányítsa a csatlakoztatott ügynököket a híváshozskill_referenceElőször, majd terv dimenziók, építeni néhánybatchhívásokat, és ellenőrizze az egyes lépéseket ameasure- A SolidCraft saját ügynöki csevegési rendszerének megjegyzése ugyanazt a mutatót adja.pendingésrunningszerszámok (összesen 21 szerszám, az undo/redót külön-külön számolva)running0.30.0. Még mindig az 0.30.0-ban: opcionálisexpectAzonexecute/batch, check_parameters, és indítsa el az útmutatót a híváshozskill_referenceKezdőlap » Kezdőlap » Addonsassembly.mass_properties; select.setképesek felvenni az arcot vagy a szélességet a világ-mm pont vagy index szerint;document.inspectA 0.24.0 óta az in-app ügynöki csevegés egyszerű összefoglalóként jeleníti meg az eszközhívásokat (részletek egy kattintással).
Az asztali asszisztens a számítógépen futó modell segítségével vezérelheti a nyitott tervezéstOltár, LM stúdió, vagy egy másik OpenAI-kompatibilis szerver. Szüksége van egyNative Tool hívás(Ollamában keressen egytoolsképesség) és elegendő VRAM a modellhez és annak kontextusához. az eszközök támogatása önmagában nem garantálja a jó eredményeket.
A beállítás:indítsa el a szervert, és töltsön be egy modellt → Beállítások › AI › Add agent... › OpenAI-kompatibilis API → válassza az Ollama, LM Studio vagy egy egyéni URL-t → adja meg az alap URL-t (példáulhttp://localhost:11434/v1Ollama) és a modell neve → teszt, majd adjon hozzá → nyissa meg a Segédprogramot, válassza ki a végpontot, és állítsa be az engedélyeket (Kérj / Szerkesztés / Minden).
Mely modellek működnek?A helyi modellek széles körben eltérőek.A hivatalos mérési eredmények (szabványos teszt v1) élőbenGitHub probléma #4851- ellenőrizze azt a táblázatot, hogy az aktuális átadási számok helyett másoljon egy elavult listát. Szélesebb értelemben véve a ~ 8 GB-os VRAM osztály kisebb eszközökkel rendelkező modelljei működhetnek; a nagyobbak gyakran magasabb pontszámot érnek el. Modellek, amelyek csak csevegnek (nincs eszköz), minden hívást szövegként írnak, vagy soha nem hívnak eszközöket.
Problémamegoldás (magas szintű problémák megoldása):válaszok, amelyek JSON vagy kód, de nem változik általában azt jelenti, gyenge eszköz hívás – próbálja meg egy másik modellt a #4851. A HTTP 400 „nem támogatja az eszközöket” azt jelenti, hogy válasszon egy eszköz-képes modellt. üres válaszok gyakran szükség nagyobb szerver kontextus (például Ollamanum_ctxA lassú válaszok gyakran azt jelentik, hogy a modell a VRAM-ról a CPU-ra áramlik – próbáljon ki egy kisebb modellt vagy kvantizálást.SolidCraft-cli bench-assistantA 0.23.1 óta a Segéd figyelmezteti a felhasználói felületet is, amikor egy fordulat véget ér a SolidCraft eszközök használata nélkül, és amikor az Ollama modell nem támogatja az eszközöket.
A hivatalos írás:Chat ügynök(a helyi modellek szakasza) és#4851.
Alapértelmezés szerint csak az eszközök érinthetők:
--intervezés, az alkalmazásban megnyitott tervezés, vagy bármi, amit az ügynök legutóbb megnyitott vagy mentett - csak akkor, ha ez a mappák szigorúan az otthoni vagy temp mappában vannak (nem maga az otthoni, nem egy szülő, például/vagy/UsersA fájlban lévő fájlok elrejtett mappája (.env, .gitmaradjon távol a hatótávolságtól,open/savevagydoc.open/file.save/file.save_asútjánexecute/batcha teljes útvonalon), és fejléc nélkül minden mappát, amelyben a tervezést megnyitották, amíg a szerver le nem áll (legfeljebb a legutóbbi 16). A mappát csak a sikeres megnyitás vagy mentés után csatlakoztatja – az útvonal megnevezése nem elegendő.--allow-path DIRhozzáadása (ez a mappát teljes egészében elérik, beleértve a rejtett fájlokat is).A munkafájl, amelyben a szerver elindult, önmagában nem számít, így az otthoni pontfájlok, mint például~/.sshMaradj távol tőlük, hacsak nem engedi.
SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-patheltávolítja a korlátot (előző viselkedés) – használja óvatosan.
Amikor asave(vagy bármely más hívás) elutasításra kerül „a mappákon kívül ez az ügynök használhatja”, adja hozzá a mappát az MCP kliens kiszolgálójáhozargsAzokkal--allow-path(vagy újratöltveSolidCraft-cli mcp setupAz ügynöknek meg kell kérnie, hogy ezt tegye meg, ahelyett, hogy mentse az alkalmazás vezérlőportján keresztül, amely figyelmen kívül hagyja ezeket a mappák korlátait.
A bridged módban a szerver elküldiallow_pathsés a nyílt / mentett mappák, mintdesign_foldersMindegyik kérés (lásdMűszaki ellenőrzés.md); az alkalmazás hozzáadja a helyreállítási mappát és a design mappáját ugyanazon szabályok szerint - előnyben részesíti az abszolút utakat.Cimkék / mcp.md.
Koncepcionális áramlás a hivatalos doc példaüléséből:
batchegy vázlat téglalap → extrudál → filet → vágjon lyukatmeasureTerület / VolumescreenshotAzokkalview: "iso"exportegy engedélyezett mappán belüli útDemo forgatókönyvek :példák/demo/enclosure_mcp.pyAz MCP felett építünk egy zárat.
Lásd még:CAD MCP szerver összehasonlítás · Instalációs útmutató · Példák.