ShapeItUp MCPサーバー
コミット 2026年10月13日TypeScriptとOpenCascadeを使用して、AIエージェントによるパラメトリックな3D CADモデルの作成、レンダリング、検証、およびエクスポートを可能にします。
別名 asbis/ShapeItUp
- スター
- 6
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月13日
- ライセンス
- MIT
ShapeItUp MCPとは
ShapeItUpはMCPサーバーです。 TypeScriptとOpenCascadeを使用して、AIエージェントによるパラメトリックな3D CADモデルの作成、レンダリング、検証、およびエクスポートを可能にします。.
プロジェクトのREADMEから生成された概要
ShapeItUp MCP server について
ShapeItUpは、TypeScriptとOpenCascadeを使用して、AIエージェントがパラメトリックな3D CADモデリングを行うための専用ツールキットを提供します。エージェントがヘッドレスインターフェースを通じて、3Dモデルの作成、レンダリング、検証、エクスポートまでの一連のワークフローを実行できます。このサーバーはstdioを介して動作し、Claude Code、Cursor、Claude Desktop、Codex、Mistral Vibeを含むさまざまなMCPクライアントと互換性があります。実行にはNode 20以降が必要です。
開発者は、組み込まれた29個のツールを使用して、設計ループ全体を管理できます。これには、形状の作成や変更、PNG形式でのプレビューレンダリング、衝突判定やスタックチェックなどの幾何学的検証が含まれます。システムはSTEP、STL、および3MF形式でのファイルエクスポートをサポートしています。WASMを使用しているため、GPUやネイティブのグラフィックススタックを必要とせず、GitHub ActionsやDockerコンテナなどのCI環境での使用に適しています。
できること
- 1幾何学的な整合性の検証開発者はAIに対し、設計内のパーツが衝突していないか、またはジョイントが有効であるかを確認するタスクを割り当てることができます。
- 2設計パラメータの反復調整エージェントはファイル全体を書き換える代わりに、スライダーによるオーバーライドを使用して特定の値を調整し、モデルを洗練させることができます。
- 3製造用モデルのエクスポートAIエージェントは、スクリプト化された設計を製造用の標準的な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はどのようなファイル形式でエクスポートできますか?
このサーバーは、STEP、STL、および3MF形式での3Dモデルのエクスポートをサポートしています。
ShapeItUpの実行にGPUや特定のグラフィックススタックは必要ですか?
いいえ、WASMを使用してレンダリングを行うため、GPUやheadless Chromium、ネイティブのグラフィックススタックなしでヘッドレス動作します。
CI/CD環境でShapeItUpを使用できますか?
はい、Docker、GitHub Actions、GitLab CIなど、Node 20が動作するあらゆる環境で使用可能です。