ShapeItUp MCP server
2026년 10월 13일 커밋TypeScript와 OpenCascade를 사용하여 AI agent가 파라메트릭 3D CAD 모델을 작성, 렌더링, 검증 및 내보낼 수 있도록 지원합니다.
다른 이름 asbis/ShapeItUp
- 스타
- 6
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 13일
- 라이선스
- MIT
ShapeItUp MCP란?
ShapeItUp은(는) MCP server입니다. TypeScript와 OpenCascade를 사용하여 AI agent가 파라메트릭 3D CAD 모델을 작성, 렌더링, 검증 및 내보낼 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
ShapeItUp MCP server 정보
ShapeItUp은 AI agent가 TypeScript와 OpenCascade를 사용하여 파라메트릭 3D CAD 모델링을 수행할 수 있는 특화된 툴킷을 제공합니다. agent가 headless 인터페이스를 통해 3D 모델을 작성, 렌더링, 검증 및 내보낼 수 있는 엔드 투 엔드 워크플로우를 지원합니다. 이 MCP server는 stdio를 통해 작동하며 Claude Code, Cursor, Claude Desktop, Codex, Mistral Vibe를 포함한 다양한 MCP client와 호환됩니다. 실행을 위해 Node 20 이상의 버전이 필요합니다.
개발자는 포함된 29개의 도구를 사용하여 전체 설계 루프를 관리할 수 있습니다. 여기에는 형상 생성 및 수정, PNG 형식의 프리뷰 렌더링, 충돌 또는 스택 확인과 같은 기하학적 검증 수행이 포함됩니다. 시스템은 STEP, STL, 3MF 형식의 파일 내보내기를 지원합니다. WASM을 사용하기 때문에 GPU나 네이티브 그래픽 스택이 필요하지 않아 GitHub Actions나 Docker 컨테이너와 같은 CI 환경에서 사용하기에 적합합니다.
활용 사례
- 1기하학적 무결성 검증개발자는 AI에게 설계된 부품 간의 충돌 여부나 조인트의 유효성을 확인하도록 요청할 수 있습니다.
- 2설계 파라미터 반복 수정agent는 전체 파일을 다시 작성하는 대신, 슬라이더 오버라이드를 사용하여 특정 값을 조정함으로써 모델을 정교화할 수 있습니다.
- 3제조를 위한 모델 내보내기AI agent는 스크립트로 작성된 설계를 생산을 위한 표준 3D 파일 형식으로 변환할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능asbis/shapeitup is public and reachablegithub.com/asbis/shapeitup ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-13github.com/asbis/shapeitup ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기ShapeItUp is an MCP server that turns Replicad / OpenCascade into AI-agent-grade CAD tooling. It writes, renders, verifies, and exports parametric 3D models from TypeScript .shape.ts files, headlessly — from the terminal, from Claude Code / Codex / Cursor / Claude Desktop / Mistral Vibe, or from CI. A VSCode extension is available as an optional interactive viewer for humans who want to watch the renders happen live.
Install for Claude Code
claude mcp add shapeitup -- npx -y @shapeitup/mcp-server
That's it. claude mcp add registers the server in your Claude Code config so agent sessions pick it up automatically. See the Claude Code MCP docs for scoping options (-s user for all projects, -s project for just this repo).
Install for Codex
codex mcp add shapeitup -- npx -y @shapeitup/mcp-server
Then raise the timeouts in ~/.codex/config.toml, under the entry that command wrote:
[mcp_servers.shapeitup]
command = "npx"
args = ["-y", "@shapeitup/mcp-server"]
startup_timeout_sec = 60
tool_timeout_sec = 180
Keep both. Codex gives a server 10 s to start, and the first npx run downloads the package, which can take half a minute. It gives a tool 60 s, and a cold render of complex geometry can need more. The Codex CLI, the IDE extension and the ChatGPT desktop app share this file. Check with codex mcp list, or /mcp inside Codex.
For the Replicad API reference, save SKILL.md where Codex looks for skills:
mkdir -p ~/.agents/skills/shapeitup && curl -fsSL https://raw.githubusercontent.com/asbis/ShapeItUp/master/skills/shapeitup/SKILL.md -o ~/.agents/skills/shapeitup/SKILL.md
Install for Cursor / Claude Desktop / other MCP clients
The generic MCP-config snippet:
{
"mcpServers": {
"shapeitup": {
"command": "npx",
"args": ["-y", "@shapeitup/mcp-server"]
}
}
}
Where to put it:
- Cursor —
~/.cursor/mcp.json, or Settings → MCP → Add new server to drop it in through the UI. - Claude Desktop —
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS,%APPDATA%\Claude\claude_desktop_config.jsonon Windows. Restart the app after editing. - Mistral Vibe — TOML rather than JSON; see below.
- Any stdio MCP client — hand it
npx -y @shapeitup/mcp-serveras the server command.
Mistral Vibe
Append to ~/.vibe/config.toml, then run /reload in Vibe:
[[mcp_servers]]
name = "shapeitup"
transport = "stdio"
command = "npx"
args = ["-y", "@shapeitup/mcp-server"]
startup_timeout_sec = 60
Keep startup_timeout_sec: Vibe's default of 10 s is shorter than the first npx download. For the Replicad API reference, save skills/shapeitup/SKILL.md as ~/.vibe/skills/shapeitup/SKILL.md. More options, including vibe mcp add, are in the MCP server README.
Node 20+ required. No native build step; everything ships as WASM.
What you get
A CAD toolkit agents can drive end to end:
- Authoring —
create_shape,modify_shape,read_shape,list_shapes,setup_shape_project - Rendering —
render_preview,preview_shape,get_preview(SVG-first, resvg-backed PNGs),open_viewer/close_viewer(interactive browser viewer) - Verification —
verify_shape,check_collisions,check_stack,sweep_check,run_simulation,describe_geometry,validate_joints - Iteration —
tune_params(slider overrides),set_render_mode,toggle_dimensions - Export —
export_shape(STEP / STL / 3MF) - stdlib —
holes,screws/bolts/washers/inserts,bearings,extrusions,patterns,threads,joints+assemble,printHints, and more — all importable from"shapeitup"inside any.shape.ts
29 MCP tools in all — the above plus helpers such as validate_syntax, preview_finder, get_api_reference and open_shape — covering the create → preview → verify → tune → export loop.
Quick example
Prompt to the agent: "I want a mounting bracket, 60×40×4 mm, four M3 through-holes in the corners." The agent calls create_shape and writes:
// bracket.shape.ts
import { drawRoundedRectangle } from "replicad";
import { holes, patterns } from "shapeitup";
export const params = { width: 60, depth: 40, thickness: 4, holeInset: 6 };
export default function main({ width, depth, thickness, holeInset }: typeof params) {
const plate = drawRoundedRectangle(width, depth, 3)
.sketchOnPlane("XY")
.extrude(thickness);
// holes.through() returns a cutter whose opening sits at Z=0 and drills -Z;
// lift it to the top face, then cut one at each corner of a 2×2 grid.
return patterns.cutAt(
plate,
() => holes.through("M3", { depth: thickness + 2 }).translate(0, 0, thickness),
patterns.grid(2, 2, width - 2 * holeInset, depth - 2 * holeInset),
);
}
Then it calls render_preview and gets back a PNG it can inspect, plus bounding-box + volume metadata to sanity-check against the spec. If the user wants the holes bigger, the agent calls tune_params — no file rewrite needed.
Running in CI / containers
npx -y @shapeitup/mcp-server works anywhere Node 20 runs — Docker, GitHub Actions, GitLab CI. Renders go through @resvg/resvg-wasm; no GPU, no headless Chromium, no native graphics stack required. A cold boot on a stock Node image typically takes ~3 s for the first render (OCCT WASM compile) and < 200 ms thereafter.
VSCode extension (optional)
There is a VSCode extension that subscribes to the MCP server's event bus and shows a live Three.js viewer in the side panel — useful when you want to watch an agent work, or to drive ShapeItUp interactively. Install it from the VS Code marketplace (search for "ShapeItUp") or build from source (see Development).
The extension is entirely optional: the MCP server is headless on its own, does not require VSCode to be running, and produces the same renders whether or not a viewer is attached.
Development
git clone https://github.com/asbis/ShapeItUp.git
cd ShapeItUp
pnpm install
pnpm build # builds extension, viewer, worker, and mcp-server
pnpm dev # watch mode
pnpm lint # tsc -b across packages
Then press F5 in VS Code to launch the Extension Development Host if you want to iterate on the viewer.
Project layout:
packages/
mcp-server/ -- standalone MCP server (this is the npm package)
core/ -- Replicad wrappers, stdlib, execution engine (bundled into mcp-server)
shared/ -- cross-package types (bundled into mcp-server)
extension/ -- VSCode extension (optional viewer)
viewer/ -- Three.js viewer surface for the extension
worker/ -- OCCT WASM web-worker for the extension viewer
See CONTRIBUTING.md for contribution guidelines.
License
MIT
ShapeItUp MCP 질문
ShapeItUp에서 어떤 파일 형식을 내보낼 수 있나요?
이 MCP server는 STEP, STL, 3MF 형식의 3D 모델 내보내기를 지원합니다.
ShapeItUp를 사용하려면 GPU나 특정 그래픽 스택이 필요한가요?
아니요, WASM을 사용하여 렌더링하므로 GPU, headless Chromium 또는 네이티브 그래픽 스택 없이도 headless 방식으로 실행됩니다.
CI/CD 환경에서 ShapeItUp를 사용할 수 있나요?
네, Docker, GitHub Actions, GitLab CI를 포함하여 Node 20이 실행되는 모든 환경에서 작동합니다.