solidcraft-cli mcp에이전트는 툴바, 스크립트 및 CLI와 동일한 엔진 명령을 실행합니다 - 스케치, 기능, 설정 매개 변수, 측정, 스크린 샷, 수출 STEP/STL, undo/redo - 대화 상자를 열지 않고.
127.0.0.1:27878(또는 27893까지의 다음 무료 포트).Preferences › Assistant › “Let AI agents connect (control channel / 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
On Snap installs the CLI 를 설치합니다.solidcraft.cli앱은 선택한 포트를control/current.port당신의 데이터 폴더에;--control / SOLIDCRAFT_CONTROL_PORT여전히 넘어간다
SOLIDCRAFT_CONTROL_TOKEN위에--tokenbridging - 명령줄 args는 프로세스 목록 (공식 문서)에서 볼 수 있습니다.solidcraft-cli 준비하기대부분 패키지는 설치 후 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이며, squashfs에서 solidcraft-cli를 추출하는 것도 유효한 대안입니다. 검증된 단계와 클라이언트 설정:
공식 MCP doc에서 :
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"]
}
}
}
고정된 항구의 경우: For a fixed port: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"]
Codex 터미널 UI에서 /mcp는 활성 서버를 보여 줍니다. solidcraft-cli가 PATH에 없으면 바이너리 전체 경로를 쓰세요(Snap: solidcraft.cli, Flatpak: flatpak run --command=solidcraft-cli ai.storyteller.solidcraft, AppImage: 첫 실행 후 ~/.local/bin 런처, 또는 CLI 위치). 별도로 앱 내 Agent chat 패널은 npm install -g @agentclientprotocol/codex-acp로 Codex를 실행할 수 있습니다(공식 문서).
.cursor/mcp.json또는~/.cursor/mcp.json확인 도구는 Reload 후 Cursor의 MCP 설정에 나타납니다.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Cursor가 PATH에서 solidcraft-cli를 찾지 못하면 바이너리 전체 경로를 쓰세요. 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 (read-only) 명령이 입력된 계약을 가지고 있는 입력 및 결과를 위한 Schemes |
execute / batch | 모델링 명령을 실행합니다. batch는 오류 시 롤백할 수 있고 rolled_back, undone, applied, not_run을 보고합니다. 선택적 coalesce_parameters(기본 false)는 연속된 단순 매개변수 편집을 합쳐 디자인을 실행당 한 번만 재빌드합니다(실행 취소 한 단계, 각 단계는 coalesced 실행 길이를 유지). 일부 도구는 단계 이름으로 쓸 수 있지만 screenshot, body_topology, batch, pending, running, skill_reference는 불가 |
inspect_design / measure / body_topology | 기하학 및 타임라인 읽기inspect_design또한 모임의 조합을 나열합니다 (Opt off withjoints: 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-checking2) 선택적file(가장 부족한reference.md읽기 전용; 파일 도구가 꺼져있을 때 에이전트 채팅에 의해 사용됩니다 (since 0.21.0) |
running | 응용 프로그램이 모든 연결 클라이언트에 대해 바쁜 것을 표시하거나 차단한 것을 표시하십시오 (파라미터가 없음); 응용 프로그램이 바쁜 동안에도 응답하십시오. |
pending | 브리지 모드 : 긴 제어 요청이 "아직도 실행 중"을 반환 한 후 60 초까지 기다리십시오.done: false걷는 동안;pending: null읽을 수 없을 때, 오직 기다리며,running, skill_reference그리고crash_reports |
오래 지속되는 요청 (bridged) :서버는 느린 제어 통화에서 최대 300s까지 차단할 수 있습니다; MCP 클라이언트 타임 아웃을 330s 이상 설정합니다.If a call times out or returns “still running”, do not resend the same change — callpending그리고 / 또는running(또는inspect_design1) 먼저
매개 변수 확인 ( 이후 0.17.0):타이핑된 계약을 가진 명령(지금까지solid.box, solid.extrude그리고engine.describe) 호출될 때 확인할 수 있으며,describe_command그들의 계획을 보여줍니다.Headless session with--param-check off|warn|strict: off그것은 변함이 없으며 변함이 없으며warn호출을 실행하지만 가능성이 잘못된 키와 같은 경고를 추가합니다.strict호출을 거부하고 디자인이 손상되지 않습니다. 실행 중인 앱으로 전송된 호출은 아직 확인되지 않습니다. 단일 조인이 무엇에 연결되어 있는지 확인하려면 실행합니다.joint.inspect통해execute출처 :v0.17.0에서 docs/mcp.md.
옵션 에이전트 Skills Live Underskills/리포트 (solidcraft-modeling, solidcraft-editingMCP : MCPskill_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제한을 제거합니다 (전의 행동) - 조심스럽게 사용하십시오.
공식 doc의 예제 세션에서 개념적 흐름 :
batcha sketch rectangle → extrude → filet → cut a holemeasureVolume / 영역screenshot와view: "iso"export허용된 폴더 안에 있는 경로로Demo 스크립트 :예제/데모/Enclosure_mcp.pyMCP 를 통해 덮여 있습니다.Build an enclosure over MCP.
또한 보세요 :CAD MCP 서버 비교 · 설치 가이드 · 예제들.